home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / rexx / tritonrexx376.lha / TritonRexx / tritonrexx.dok < prev    next >
Text File  |  1995-09-17  |  130KB  |  3,472 lines

  1.  
  2.  
  3. ##########################################################################
  4.  
  5.                     'tritonrexx.library' 37.6 (17.9.95)
  6.  
  7.    Copyright (C) 1994,95 Jⁿrgen Kohrmeyer, <J_Kohrmeyer@wilam.north.de>
  8.  
  9. ##########################################################################
  10.  
  11. Allgemeines
  12.  
  13. * ▄bersicht                   - Kurze Vorstellung der Library
  14. * Copyright                   - Copyright und sonstige rechtliche Dinge
  15. * History                     - Geschichtliche Entwicklung der Library
  16. * Danksagungen                - Ich m÷chte mich bedanken bei...
  17. * Adresse des Autors          - Wohin man Kommentare und Bugreports schickt
  18. * Systemvoraussetzungen       - 68040, 18MB Ram ;-)
  19. * Installation                - Installation der Library
  20. * Triton-Info                 - Informationen ⁿber 'Triton'
  21.  
  22. Grundlagen
  23.  
  24. * triton.library              - Gemeinsamkeiten mit der 'triton.library'
  25. * Applikationen und Projekte  - Die Grundlagen fⁿr ein Programm
  26. * Taglisten verwenden         - Wie Taglisten funktionieren
  27. * OberflΣchen erstellen       - Wie ein Fenster aufgebaut wird
  28. * Tips und Probleml÷sungen    - Was tun wenn...
  29. * FlushTRX                    - Befehl zum Entfernen von Applikationen
  30.  
  31. Programmieren
  32.  
  33. * Applikationen               - Eigenschaften von Applikationen
  34. * Projekte/Fenster            - Eigenschaften von Projekten/Fenstern
  35. * Menⁿs                       - Eigenschaften von Menⁿs
  36. * Objekte und Attribute       - Menⁿs, Gadgets, Texte und Images
  37. * Funktionen                  - Funktionen der Library
  38.  
  39. Sonstiges
  40.  
  41. * Index                       - Stichwortverzeichnis
  42.  
  43. ▄bersicht
  44. *********
  45.  
  46. Die 'tritonrexx.library' ist eine ARexx-Funktionslibrary. Sie enthΣlt
  47. Funktionen zur Programmierung von BenutzeroberflΣchen mit ARexx, zur
  48. Erstellung der OberflΣchen wird die 'triton.library' verwendet.
  49. Siehe Triton-Info.
  50.  
  51.    * Alle Features der 'triton.library V1.3' werden voll unterstⁿtzt
  52.  
  53.    * Einfache Programmierung von Fenstern, Menⁿs, Gadgets und Requestern
  54.  
  55.    * Datei-, und Fontrequester mit der 'asl.library'
  56.  
  57.    * Einbindung von beliebigen Grafiken (Kickstart 3.0 erforderlich)
  58.  
  59.    * Laden von Grafikdaten mit der 'datatypes.library'
  60.  
  61. Copyright und sonstige rechtliche Dinge
  62. ***************************************
  63.  
  64. Die 'tritonrexx.library' ist FREEWARE, das Copyright bleibt weiterhin beim
  65. Autor Jⁿrgen Kohrmeyer. Das Archiv darf frei kopiert werden, solange es
  66. unverΣndert weitergegeben, und nur eine geringe Kopiergebⁿhr erhoben wird.
  67. Das unverΣnderte Archiv darf in Mailboxen zum Download angeboten werden, es
  68. ist jedoch nicht erlaubt Geld dafⁿr zu verlangen oder dem Archiv Werbetexte
  69. hinzuzufⁿgen. Das Archiv darf in Public-Domain Sammlungen aufgenommen
  70. werden, es darf jedoch nicht auf Disketten vertrieben werden die mehr als 4,-
  71. DM kosten! Der Vertrieb des Archivs auf 'CD-ROM' ist nur erlaubt, wenn der
  72. Preis fⁿr eine CD 30,- DM nicht ⁿbersteigt!
  73.  
  74. Die Weitergabe der 'tritonrexx.library' zusammen mit anderen Programmen ist
  75. nur gestattet, wenn es sich um 'PUBLIC DOMAIN' oder 'FREEWARE' handelt.  Bei
  76. allen anderen Arten von Software ist die Genehmigung des Autors unbedingt
  77. erforderlich. In jedem Fall mu▀ bei der Ver÷ffentlichung ein Hinweis auf
  78. die 'tritonrexx.library', den Autor und die Bezugsquelle fⁿr das
  79. Komplettarchiv gegeben werden. Siehe Adresse des Autors.
  80.  
  81. Der Vertrieb der 'tritonrexx.library' zu kommerziellen Zwecken jeglicher Art
  82. ist nur mit Genehmigung des Autors gestattet!
  83.  
  84. Der Autor gibt keine Garantie fⁿr die ZuverlΣssigkeit der im Archiv
  85. enthaltenen Programme und Dateien! Sie benutzen die Dateien auf eigene
  86. Gefahr! Der Autor kann nicht fⁿr irgendwelche SchΣden haftbar gemacht
  87. werden, die durch die Anwendung der Programme oder Dateien entstehen!
  88.  
  89.  
  90. 'triton.library'
  91. ================
  92.  
  93. Zur Erstellung und Auswertung der OberflΣchen wird die 'triton.library'
  94. verwendet, ein gro▀er Teil dieser Anleitung besteht aus der ▄bersetzung der
  95. 'Triton-Anleitung'!
  96.  
  97. Die 'triton.library' ist Copyright (C) by Stefan Zeiger.
  98.  
  99. Siehe Triton-Info.
  100.  
  101.  
  102. ARexx-Skripte und sonstige Programme
  103. ====================================
  104.  
  105. Im Archiv befinden sich mehrere ARexx-Skripte und Programme:
  106.  
  107.    * 'Break.rexx' ist Copyright (C) Nils Goers
  108.  
  109.    * 'ChangeSTARTPRI.rexx' ist Copyright (C) Nils Goers
  110.  
  111.    * 'Exchange.rexx' ist Copyright (C) Nils Goers
  112.  
  113.    * 'ARexxControl' ist Copyright (C) Jⁿrgen Kohrmeyer
  114.  
  115.    * 'HandleCX' ist Copyright (C) Martin Berndt
  116.  
  117. Entstehungsgeschichte
  118. *********************
  119.  
  120. V37.1
  121.      Erste Alphaversion, Special-Herm-Edition ;-)
  122.  
  123. V37.2
  124.      Erste Betaversion
  125.  
  126. V37.6
  127.      Erste ver÷ffentlichte Version
  128.  
  129. Danksagungen
  130. ************
  131.  
  132. Mein Dank gilt:
  133.  
  134.  
  135. Stefan Zeiger fⁿr seine gro▀artige 'triton.library', ohne die
  136.   dieses Projekt nicht m÷glich gewesen wΣre.
  137.  
  138. Nils Goers fⁿr seine ARexx-Skripte, die er extra fⁿr das Archiv
  139.   programmiert hat, fⁿr das Testen der Beta-Version und seine VorschlΣge
  140.   und Ideen.
  141.  
  142. Ralf Reiser, der es auch als ARexx-Einsteiger geschafft hat
  143.   mit TritonRexx klarzukommen, fⁿr seine vielen Anregungen.
  144.  
  145. Hermann D÷rries fⁿr sein hervorragendes Mailbox-System 'Wilam'
  146.  
  147. * Allen, die mir ihre Ideen mitgeteilt, oder Bugs gemeldet haben.
  148.  
  149. Adresse des Autors
  150. ******************
  151.  
  152. Der Autor ist unter folgenden Adressen erreichbar, bitte vorzugsweise die
  153. E-Mail Adresse benutzen:
  154.  
  155. Postanschrift:
  156.      Jⁿrgen Kohrmeyer
  157.      Oststra▀e 2
  158.      49143 Bissendorf
  159.  
  160. Telefon:
  161.      +49-5402-5195
  162.  
  163. E-Mail:
  164.      j_kohrmeyer@wilam.north.de
  165.  
  166. Support-Mailbox:
  167.      WILAM Mailboxsystem Wildeshausen
  168.      
  169.      Port 1 - +49-4431-92081 : USR DualStandard V.34
  170.      Port 2 - +49-4431-92082 : ZyXel 19.2k
  171.      Port 3 - +49-4431-92082 : ISDN X.75
  172.      
  173.      Login mit Username MD, Download per Menⁿauswahl
  174.  
  175. Systemvoraussetzungen
  176. *********************
  177.  
  178.    * Die 'tritonrexx.library' ben÷tigt mindestens Kickstart/Workbench 2.04.
  179.  
  180.    * Zur Einbindung von Grafiken wird mindestens Kickstart 3.0 ben÷tigt.
  181.  
  182.    * Ein 68020+ Prozessor wird dringend empfohlen, die Library lΣuft aber
  183.      auch auf 68000er Systemen.
  184.  
  185.    * Die 'triton.library', mindestens 'V1.3', wird unbedingt be÷tigt.  Siehe
  186.      Triton-Info.
  187.  
  188.    * Der ARexx-Interpreter RexxMast mu▀ gestartet sein.
  189.  
  190. Installation
  191. ************
  192.  
  193. Die Installation wird durch Doppelklick auf das 'Install'-Piktogramm
  194. gestartet, es wird das Standard-Installationsprogramm 'Installer' verwendet.
  195.  
  196. Au▀erdem mu▀ die 'triton.library' installiert werden, dies wird nicht vom
  197. oben beschriebenen Programm durchgefⁿhrt. Im Verzeichnis 'Triton' befindet
  198. sich dazu ein Installationsprogramm.
  199.  
  200. Die Verwendung der Library setzt voraus, da▀ der ARexx-Interpreter zuvor
  201. gestartet wurde. Das Programm, das den Arexx-Interpreter startet, befindet
  202. sich in der Schublade SYS:System und hei▀t RexxMast. Falls dieses Programm
  203. in Ihrem System nicht automatisch gestartet wird mⁿssen Sie es manuell
  204. starten. Die einfachste Methode ist es aber, das Programm RexxMast in der
  205. Batchdatei S:User-Startup aufzurufen. Dadurch wird ARexx bei jedem Start
  206. des Rechners automatisch aufgerufen und im System installiert.
  207.  
  208. Zum Starten des ARexx-Interpreters fⁿgen Sie folgende Zeile in Ihre
  209. S:User-Startup ein:
  210.  
  211.      SYS:System/RexxMast >NIL:
  212.  
  213. Informationen ⁿber 'Triton'
  214. ***************************
  215.  
  216. Im Verzeichnis 'Triton' des TritonRexx-Archivs ist die AmigaOS 2.04+ Version
  217. der 'triton.library' enthalten:
  218.  
  219.                **********************************************
  220.  
  221.                                    Triton
  222.  
  223.                    An object oriented GUI creation system.
  224.  
  225.                                  Release 1.3
  226.  
  227.                          (c) 1993-1995 Stefan Zeiger
  228.  
  229.                **********************************************
  230.  
  231.  
  232.     This  is  a  minimum  distribution version of Triton, the object oriented
  233. graphical  user  interface creation system for AmigaOS.  Not included in this
  234. minimum distribution are:
  235.  
  236.     - A Prefs editor for customizing Triton GUIs
  237.     - An optimized version of triton.library for OS3.0+
  238.     - Language catalogs
  239.     - Developer support material
  240.  
  241.     If you want a full distribution,  you may download Triton from the BBS of
  242. 'Tec Mania Systems':
  243.  
  244.                   >--------------------------------------<
  245.                     Tec Mania Systems
  246.  
  247.                     SysOp: Bernd Hassenzahl
  248.  
  249.                     Phone: +49-6157-8742-7 (V34 28k8)
  250.                            +49-6157-8742-8 (V32t 19k2)
  251.                            +49-6157-91012-1 (ISDN X75)
  252.                            +49-6157-91012-2 (ISDN X75)
  253.                   >--------------------------------------<
  254.  
  255.     Please  log  in  as  a  guest  and  download  Triton  from  the directory
  256. '/T-M-S/BINAER/AMIGA/WIZARD-WORKS'.
  257.  
  258.     The latest  Triton user  archive can  also be  obtained  via FidoNet file
  259. request as 'TRITON' from 'Publishers Treff BBS':
  260.  
  261.                   >--------------------------------------<
  262.                     Publishers Treff
  263.  
  264.                     SysOp: Christoph Reichert
  265.  
  266.                     FidoNet: 2:244/6302.0
  267.                   >--------------------------------------<
  268.  
  269.  
  270.     Contacting the author:
  271.  
  272.         EMail:      s.zeiger@laren.rhein-main.de
  273.  
  274.         FidoNet:    Stefan Zeiger 2:244/6302.15
  275.  
  276.         Mail:       Stefan Zeiger
  277.                     SeligenstΣdter Weg 24
  278.                     D-63796 Kahl
  279.                     Germany
  280.  
  281.         Voice:      +49-6188-2684 (new!)
  282.  
  283.     Please use  EMail if possible.  This is  more convenient  for me and your
  284. chance of getting a reply quickly is much better.
  285.  
  286.  
  287.                                                 Live long and prosper!
  288.  
  289. Gemeinsamkeiten mit der 'triton.library'
  290. ****************************************
  291.  
  292. Die 'triton.library' wird von fast allen Funktionen sehr intensiv genutzt.
  293. Viele Funktionen konvertieren lediglich die Argumente, rufen danach die
  294. entsprechende Triton-Funktion auf, und ⁿbermitteln die Rⁿckgabewerte an das
  295. aufrufende ARexx-Skript.
  296.  
  297. SΣmtliche Angaben zur Programmierung, in der Dokumentation, den Autodocs und
  298. dem C-Includefile 'libraries/triton.h', der 'triton.library' gelten auch fⁿr
  299. die 'tritonrexx.library'. Alle Funktionen, Objekte, Attribute und Flags haben
  300. die gleiche Bedeutung und sollten sich entsprechend dieser Dokumentation
  301. verhalten.
  302.  
  303. Die Schreibweise der Funktionsnamen ist mit der 'triton.library' identisch,
  304. mit dem Unterschied, da▀ nicht auf Gro▀- und Kleinschreibung geachtet wird.
  305.  
  306. Alle im C-Includefile 'libraries/triton.h' aufgefⁿhrten Makros sind in der
  307. 'tritonrexx.library' als Funktionen enthalten und k÷nnen wie gewohnt
  308. verwendet werden. Auch hier wird nicht auf Gro▀- und Kleinschreibung
  309. geachtet.
  310.  
  311. Die Schreibweise aller Attribute und Flags ist identisch mit den Definitionen
  312. im C-Includefile 'libraries/triton.h' und den Beschreibungen in den Autodocs.
  313. Hier wird ebenfalls nicht auf Gro▀- und Kleinschreibung geachtet.
  314.  
  315. Siehe Triton-Info.
  316.  
  317. Applikationen und Projekte
  318. **************************
  319.  
  320.     Applikationen
  321.  
  322. Die Applikation ist die Grundlage fⁿr alle Fenster, die mit den Funktionen
  323. der 'tritonrexx.library' programmiert werden sollen. Jedes Skript mu▀ eine
  324. solche Applikation erzeugen, bevor das erste Fenster ge÷ffnet werden kann.
  325. Am Ende eines Skripts mu▀ jede erzeugte Applikation wieder gel÷scht werden,
  326. damit der zugeh÷rige Speicher an das System zurⁿckgegeben wird.
  327.  
  328. Jeder Applikation mu▀ ein kurzer Name gegeben werden, der zur Identifikation
  329. der Applikation dient.
  330.  
  331.     Projekte
  332.  
  333. Jedes Projekt ist ein Ableger einer bestimmten Applikation. Es beinhaltet
  334. genau ein Fenster, inclusive aller Eigenschaften, Menⁿs und Objekte. Jedem
  335. Projekt sollte eine einmalige ID-Nummer zugewiesen werden, diese Nummer
  336. wird von der 'triton.library' zum Speichern der Fensterposition und Gr÷▀e
  337. verwendet.
  338.  
  339. Beim ╓ffnen eines Projekts mⁿssen die gewⁿnschten Eigenschaften des
  340. Fensters, alle Menⁿs und darzustellenden Objekte mit ihren Eigenschaften
  341. angegeben werden. Objekte sind z.B. Gadgets, Texte und Grafiken. Einige der
  342. Fenster- und Objekteigenschaften lassen sich auch nachtrΣglich verΣndern.
  343.  
  344. Als erstes mⁿssen die Eigenschaften des Fensters angegeben werden, danach die
  345. Menⁿs, und zum Schlu▀ die Objekte.
  346.  
  347. Taglisten verwenden
  348. *******************
  349.  
  350. Die gesamte Definition aller Applikationen und Projekte erfolgt mit Hilfe von
  351. sogenannten Taglisten. Eine Tagliste ist die Aneinanderreihung von
  352. verschiedenen Attributen, die das Aussehen und Verhalten der beschriebenen
  353. Applikation, eines Projekts oder Objekts bestimmen.
  354.  
  355. Jedes Attribut besteht immer aus einer Kennung und einer dazu geh÷renden
  356. Datenangabe. Die einzelnen Attribute werden durch Leerzeichen oder Tabs
  357. getrennt hintereinander geschrieben.
  358.  
  359. Die Datenangabe hat verschiedene Formate, je nach Art der ⁿbergebenen Daten:
  360. ============================================================================
  361.  
  362. Boolscher Wert
  363.      0 (falsch) oder 1 (wahr)
  364.  
  365. Integerzahl
  366.      Eine Zahl zwischen -2147483648 und 2147483647
  367.  
  368. Zeichenkette
  369.      Eine beliebige Zeichenkette, wenn darin Leerzeichen oder Tabulatoren
  370.      enthalten sind mu▀ die Zeichenkette in Anfⁿhrungszeichen gesetzt
  371.      werden.
  372.  
  373.      Wenn die Zeichenkette in Anfⁿhrungszeichen gesetzt ist dient das
  374.      Zeichen '*' als Steuerzeichen. Der '*' wird dann nicht in die
  375.      Zeichenkette ⁿbernommen, sondern das nachfolgende Zeichen kann eine
  376.      bestimmte Bedeutung haben:
  377.  
  378.      *E - ein Escape-Zeichen (ASCII 27)
  379.      
  380.      *N - ein Zeilenvorschub (ASCII 10)
  381.      
  382.      *" - ein Anfⁿhrungszeichen
  383.      
  384.      ** - ein '*'
  385.  
  386.      Alle anderen Zeichen werden ohne ─ndrung ⁿbernommen, um den Text
  387.      "Hallo Welt" zu erhalten mⁿ▀te man also "*"Hallo Welt*"" schreiben.
  388.  
  389. Flags
  390.      Flags, die Eigenschaften eines Objekts angeben. Die Flags werden getrennt
  391.      durch '|' hintereinandergeschrieben. Diese Angabe darf keine Leerzeichen
  392.      enthalten.
  393.  
  394. Feld oder Liste von Zeichenketten
  395.      Der Name einer Stem-Variablen, in der die Zeichenketten enthalten sind.
  396.      Die Zeichenketten mⁿssen wie folgt gespeichert sein:
  397.  
  398.      stemvar.0 - enthΣlt die Anzahl der Zeichenketten stemvar.1 - enthΣlt
  399.      die erste Zeichenkette stemvar.2 - enthΣlt die zweite Zeichenkette
  400.      stemvar.3 - enthΣlt die dritte Zeichenkette stemvar.n - enthΣlt die
  401.      n'te Zeichenkette
  402.  
  403. Zeiger
  404.      Dies betrifft Project-, Screen- und Window-Zeiger, die von anderen
  405.      Funktionen zurⁿckgegeben wurden. Die Rⁿckgabewerte enthalten dann eine
  406.      Zahl im binΣren Format, die so nicht als Datenangabe verwendet werden
  407.      kann. Ein solcher Zeiger mu▀ fⁿr die Angabe in einer Tagliste mit der
  408.      ARexx-Funktion C2D() in eine Zahl umgewandelt werden.
  409.  
  410. TextAttr-Struktur
  411.      Der Name einer Stem-Variablen, die die Elemente einer TextAttr-Struktur
  412.      enthΣlt. Die Variable mu▀ wie folgt aufgebaut sein:
  413.  
  414.      stemvar.ta_name  - EnthΣlt den Namen des Fonts, z.B. 'helvetica.font'
  415.      stemvar.ta_ysize - EnthΣlt die Gr÷▀e des Fonts
  416.      stemvar.ta_style - EnthΣlt eine Zahl, die den Stil des Fonts beschreibt:
  417.      
  418.                         0 - normal
  419.                         1 - unterstrichen
  420.                         2 - fett
  421.                         3 - unterstrichen und fett
  422.                         4 - kursiv
  423.                         5 - unterstrichen und kursiv
  424.                         6 - fett und kursiv
  425.                         7 - unterstrichen, fett und kursiv
  426.      
  427.                         ta_style mu▀ nicht angegeben werden, Standard ist 0.
  428.  
  429. Image
  430.      Der logische Name einer Grafik, die zuvor mit 'CREATEIMAGE()' geladen
  431.      wurde.
  432.  
  433. TR_Dimensions-Struktur
  434.      Eine Stem-Variable, die die Elemente einer TR_Dimensions-Struktur
  435.      enthΣlt.  Die Variable mu▀ wie folgt aufgebaut sein:
  436.  
  437.      stemvar.trd_left    - Die linke Ecke des Fensters
  438.      stemvar.trd_top     - Die obere Ecke des Fensters
  439.      stemvar.trd_width   - Die Breite des Fensters
  440.      stemvar.trd_height  - Die H÷he des Fensters
  441.      stemvar.trd_left2   - Die alternative linke Ecke des Fensters
  442.      stemvar.trd_top2    - Die alternative obere Ecke des Fensters
  443.      stemvar.trd_width2  - Die alternative Breite des Fensters
  444.      stemvar.trd_height2 - Die alternative H÷he des Fensters
  445.      stemvar.trd_zoomed  - Fenster gezoomt? - 0 oder 1
  446.  
  447. Ungenutzt
  448.      Die Datenangabe wird momentan nicht verwendet, mu▀ aber angegeben
  449.      werden.  Am besten man gibt hier immer 0 an!
  450.  
  451. Den Abschlu▀ einer Tagliste bildet immer 'TAG_END' oder 'TAG_DONE', hier mu▀
  452. keine Datenangabe mehr gemacht werden.
  453.  
  454. Beispiel fⁿr eine Tagliste:
  455. ===========================
  456.  
  457. apptags = 'TRCA_Name     Wilko',
  458.           'TRCA_LongName Wilam-Mailboxverwaltung',
  459.           'TRCA_Info     "Point-, Kosten- und Textverwaltung fⁿr Wilam"',
  460.           'TRCA_Version  3.0',
  461.           'TRCA_Release  1',
  462.           'TRCA_Date     24.7.95',
  463.           'TAG_END'
  464.  
  465. Bei diesem Beispiel dient das Komma am Ende jeder Zeile als
  466. Fortsetzungszeichen, die Anweisung wird von ARexx wie eine Zeile behandelt.
  467.  
  468. OberflΣchen erstellen
  469. *********************
  470.  
  471. Jedes Fenster wird in Gruppen aufgeteilt. Eine Gruppe ist ein Bereich in dem
  472. sich verschiedene Objekte befinden. Dies k÷nnen auch wieder Gruppen sein,
  473. die dann andere Objekte enthalten usw.
  474.  
  475. GrundsΣtzlich gibt es zwei Arten von Gruppen:
  476. =============================================
  477.  
  478. Horizontale Gruppen - TRGR_Horiz
  479.      Die darin enthaltenen Objekte werden nebeneinander dargestellt. Die
  480.      zweite Dimension einer solchen Gruppe ist vertikal, dies dient zur
  481.      Ausrichtung der enthaltenen Objekte untereinander.
  482.  
  483. Vertikale Gruppen - TRGR_Vert
  484.      Die darin enthaltenen Objekte werden untereinander dargestellt. Die
  485.      zweite Dimension einer solchen Gruppe ist horizontal, dies dient
  486.      wiederum zur Ausrichtung der enthaltenen Objekte untereinander.
  487.  
  488. Einer Gruppe k÷nnen verschiedene Layout-Eigenschaften zugeordnet werden:
  489. ========================================================================
  490.  
  491. TRGR_PROPSHARE
  492.      Alle Objekte werden proportional zu ihrer minimalen Gr÷▀e skaliert.
  493.      Alle LeerrΣume bleiben dabei unverΣndert, das gleiche gilt auch fⁿr
  494.      alle nicht skalierbaren Objekte.
  495.  
  496. TRGR_EQUALSHARE
  497.      Alle Objekte haben in der primΣren Dimension die gleiche Gr÷▀e. Alle
  498.      Objekte sind mindestens so gro▀ wie das kleinste Objekt. Fⁿr LeerrΣume
  499.      und nicht skalierbare Objekte gilt das gleiche wie bei 'TRGR_PROPSHARE'.
  500.  
  501. TRGR_PROPSPACES
  502.      Alle Objekte, mit Ausnahme der LeerrΣume, behalten ihre minimale
  503.      Gr÷▀e.  Die LeerrΣume werden proportional zu ihrer minimalen Gr÷▀e
  504.      skaliert.
  505.  
  506. TRGR_ARRAY
  507.      Eine solche Gruppe bildet die Obergruppe einer Tabelle von Objekten. Um
  508.      eine solche Tabelle anzulegen mu▀ eine Obergruppe mit der Eigenschaft
  509.      'TRGR_ARRAY' erzeugt werden, horizontal fⁿr eine spaltenorientierte,
  510.      vertikal fⁿr eine zeilenorientierte Tabelle. In der 'TRGR_ARRAY'-Gruppe
  511.      k÷nnen einzelne Objekte oder Untergruppen mit der entgegengesetzten
  512.      Richtung enthalten sein, diese Objekte werden dann tabellarisch innerhalb
  513.      der Gruppe angeordnet.
  514.  
  515. TRGR_INDEP
  516.      Untergruppen einer 'TRGR_ARRAY'-Gruppe, die das Attribut 'TRGR_INDEP'
  517.      besitzen, werden unabhΣngig von der Tabelle angeordnet, dies wird
  518.      hauptsΣchlich zum Einfⁿgen von Trennlinien verwendet.
  519.  
  520. Eigenschaften fⁿr die Ausrichtung der Objekte in der zweiten Dimension:
  521. =======================================================================
  522.  
  523. TRGR_ALIGN
  524.      Alle in der zweiten Dimension der Gruppe skalierbaren Objekte werden auf
  525.      die volle Gr÷▀e der Gruppe skaliert.
  526.  
  527. TRGR_CENTER
  528.      Alle in der zweiten Dimension nicht skalierbaren Objekte werden
  529.      innerhalb der Gruppe zentriert.
  530.  
  531. Die Skalierbarkeit einer Gruppe kann auch abgeschaltet werden:
  532. ==============================================================
  533.  
  534. TRGR_FIXHORIZ
  535.      Die Gruppe behΣlt immer ihre minimale Breite.
  536.  
  537. TRGR_FIXVERT
  538.      Die Gruppe behΣlt immer ihre minimale H÷he.
  539.  
  540. Bei der Definition mu▀ jede Gruppe mit 'TRGR_Horiz' oder 'TRGR_Vert'
  541. begonnen werden. Die Datenangabe enthΣlt die der Gruppe zugeordneten
  542. Eigenschaften getrennt durch '|'. Den Abschlu▀ einer Gruppe bildet immer
  543. 'TRGR_End'. Die Datenangabe spielt dabei keine Rolle, mu▀ aber vorhanden
  544. sein.
  545.  
  546. Tips und Probleml÷sungen
  547. ************************
  548.  
  549.    * Tip: Einbinden der Library mit erh÷hter PrioritΣt
  550.  
  551.      Die 'tritonrexx.library' sollte mit erh÷hter PrioritΣt eingebunden
  552.      werden, so da▀ sie von ARexx vor allen anderen Libraries nach
  553.      Funktionen durchsucht wird.
  554.  
  555.      In Taglisten werden sehr hΣufig die fⁿr die einzelnen Objekte
  556.      angebotenen Makro-Funktionen verwendet, beim Interpretieren der
  557.      Taglisten mⁿssen dadurch sehr viele Funktionen aufgerufen werden. Die
  558.      erh÷hte PrioritΣt kann dabei eine erhebliche Steigerung der
  559.      Geschwindigkeit bewirken!
  560.  
  561.      'tritonrexx.library' mit PrioritΣt 10 einbinden:
  562.      --------------------------------------------------------------------------
  563.      IF ~SHOW('LIBRARIES','tritonrexx.library') THEN DO
  564.         IF ~ADDLIB('tritonrexx.library',10,-30,0) THEN DO
  565.            SAY 'Kann die <tritonrexx.library> nicht ÷ffnen!'
  566.            EXIT(10)
  567.         END
  568.      END
  569.  
  570.    * Beim Aufruf von Funktionen kommt es zu Fehlern, obwohl alle Argumente
  571.      richtig angegeben sind.
  572.  
  573.      Dies liegt oft daran, da▀ andere Libraries mit gleichnamigen Funktionen
  574.      durch die ARexx-Funktion 'AddLib()' oder den DOS-Befehl 'RXLib' in die
  575.      Suchliste von ARexx eingebunden wurden. In diesem Fall ist es oft sehr
  576.      schwierig, weiterhin beide Libraries gleichzeitig zu verwenden. Um dieses
  577.      Problem zu l÷sen kann man erst einmal versuchen, durch unterschiedliche
  578.      PrioritΣten bei 'AddLib()' oder 'RXLib' die Suchreihenfolge von ARexx
  579.      entsprechend zu verΣndern. Falls dies nicht zum gewⁿnschten Ergebnis
  580.      fⁿhrt gibt es noch eine andere, eigentlich sogar bessere Methode. Alle
  581.      Funktionen der 'tritonrexx.library' k÷nnen auch ⁿber ein Alias
  582.      aufgerufen werden, indem man dem Funktionsnamen ein 'TRX_' voranstellt.
  583.      Fⁿr die Funktion 'TR_OpenProject()' wΣre der Aliasname z.B.
  584.      'TRX_TR_OpenProject()'.
  585.  
  586.    * Nach dem Abbruch eines Skripts durch Fehler bleiben Fensterleichen
  587.      zurⁿck.
  588.  
  589.      Wenn ein Skript mit einem Fehler abbricht, dann bleiben die in diesem
  590.      Skript bereits ge÷ffneten Fenster funktionsunfΣhig auf dem Bildschirm
  591.      zurⁿck, auch Grafiken k÷nnen sich noch im Speicher befinden. Zum
  592.      Schlie▀en solcher Fenster, Entfernen der zugeh÷rigen Applikation, und
  593.      L÷schen von ungenutzten Grafiken, dient der mitgelieferte DOS-Befehl
  594.      'FlushTRX'.
  595.  
  596.      Siehe FlushTRX.
  597.  
  598.      Ein fertig ausgetestetes Skript sollte auf jeden Fall die verschiedenen
  599.      Unterbrechungssignale von ARexx nutzen, um im Fehlerfall alle ge÷ffneten
  600.      Applikationen und Grafiken zu entfernen.
  601.  
  602.      Beispiel:
  603.      --------------------------------------------------------------------------
  604.      /*
  605.      ** Applikation beim Auftreten eines Unterbrechungssignals
  606.      ** automatisch l÷schen und Skript ordnungsgemΣ▀ beenden.
  607.      */
  608.      
  609.      SIGNAL ON break_c
  610.      SIGNAL ON failure
  611.      SIGNAL ON halt
  612.      SIGNAL ON ioerr
  613.      SIGNAL ON syntax
  614.      
  615.      app = TR_CREATEAPP('TRCA_Name     Beispiel',
  616.                         'TRCA_LongName "Beispiel fⁿr SIGNAL"',
  617.                         'TRCA_Info     "ARexx-Unterbrechungssignale nutzen"',
  618.                         'TRCA_Version  1.0',
  619.                         'TRCA_Release  1',
  620.                         'TRCA_Date     30.7.95',
  621.                         'TAG_END')
  622.      
  623.      IF app ~= '00000000'x THEN DO
  624.      
  625.         /*
  626.         ** Hier steht das Skript
  627.         */
  628.      
  629.         CALL TR_DELETEAPP(app)
  630.      END
  631.      
  632.      EXIT(0)
  633.      
  634.      break_c:
  635.      failure:
  636.      halt:
  637.      ioerr:
  638.      syntax:
  639.         SAY '+++ Fehler' rc 'in Zeile' sigl '-' ERRORTEXT(rc)
  640.         SAY SOURCELINE(sigl)
  641.      
  642.         IF app ~= '00000000'x THEN
  643.            CALL TR_DELETEAPP(app)
  644.      
  645.         EXIT(10)
  646.  
  647. Der DOS-Befehl FlushTRX
  648. ***********************
  649.  
  650. Dieser Befehl dient zum Entfernen von Applikationen, die nach dem Abbruch
  651. eines fehlerhaften Skripts nicht wieder gel÷scht wurden. Es k÷nnen immer
  652. nur komplette Applikationen entfernt werden, das Schlie▀en von einzelnen
  653. Fenstern ist nicht m÷glich!  Ungenutzte Grafiken, die sich noch im Speicher
  654. befinden, k÷nnen ebenfalls gel÷scht werden. 'FlushTRX' entfernt, wenn
  655. m÷glich, auch die 'tritonrexx.library' aus dem Speicher.
  656.  
  657. Eine Applikation, auf die noch ein Skript zugreift, kann nicht entfernt
  658. werden. Dies ist z.B. der Fall, wenn ein Skript gerade mit 'TR_Wait()' auf
  659. Nachrichten von der Applikation wartet. Wenn ein Skript aber mit anderen
  660. Dingen beschΣftigt ist, und die Applikation deshalb momentan nicht anspricht,
  661. ⁿbernimmt 'FlushTRX' die Applikation und entfernt sie. Das Skript bricht
  662. dann beim nΣchsten Zugriffsversuch auf die nicht mehr bestehende Applikation
  663. mit dem Fehler 18 ab:
  664.  
  665.      Command returned 10/18: Invalid argument to function
  666.  
  667. Grafiken k÷nnen nur gel÷scht werden, wenn sie nicht mehr in einem Fenster
  668. dargestellt werden.
  669.  
  670.     Au▀er dem Befehl 'FlushTRX' gibt es keine systemkonforme M÷glichkeit,
  671. solche Applikationen nachtrΣglich zu entfernen! Grafiken k÷nnen auch
  672. nachtrΣglich mit 'DeleteImage()' (Siehe DeleteImage().) gel÷scht werden.
  673. Das Entfernen der 'tritonrexx.library' aus dem Speicher ist erst dann
  674. m÷glich, wenn alle Applikationen und Grafiken gel÷scht sind.
  675.  
  676. Format
  677.      FlushTRX [[APPLICATION] <AppName>] [IMAGES] [ALL]
  678.  
  679. Schablone
  680.      FlushTRX APPLICATION,IMAGES/S,ALL/S
  681.  
  682. Argumente
  683.      APPLICATION - Der Name der zu entfernenden Applikation. Dies ist der
  684.                    einmalige Name, der beim Erzeugen der Applikation unter
  685.                    'TRCA_Name' angegeben wurde. Siehe Applikationen. Hier kann
  686.                    auch ein AmigaDOS-Namensmuster angegeben werden, FlushTRX #?
  687.                    entfernt z.B. alle momentan nicht verwendeten Applikationen.
  688.      
  689.      IMAGES      - Wenn dieser Schalter angegeben ist, versucht das Programm
  690.                    alle noch im Speicher befindlichen Grafiken zu l÷schen.
  691.                    Die Anzahl der Grafiken, die gel÷scht werden konnten,
  692.                    wird im Shell-Fenster ausgegeben.
  693.      
  694.      ALL         - Wenn dieser Schalter angegeben ist, versucht das Programm
  695.                    alle noch im Speicher befindlichen Applikationen und
  696.                    Grafiken zu l÷schen. Dies ist jedoch nur dann m÷glich,
  697.                    wenn kein Skript mehr auf eine Applikation zugreift.
  698.  
  699. Eigenschaften von Applikationen
  700. *******************************
  701.  
  702. ATTRIBUTE
  703.      Kennung                 Datenangabe          Beschreibung
  704.      --------------------------------------------------------------------------
  705.      TRCA_Name               Zeichenkette         Ein einmaliger Name fⁿr die
  706.                                                   Applikation, nicht lΣnger
  707.                                                   als 20 Zeichen. Die Zeichen
  708.                                                    ' ', '/', '.' und ':' sind
  709.                                                   nicht erlaubt.
  710.      
  711.      TRCA_LongName           Zeichenkette         Ein Name fⁿr die Applikation,
  712.                                                   der fⁿr Jeden sichtbar ist,
  713.                                                   bis zu 60 Zeichen.
  714.      
  715.      TRCA_Info               Zeichenkette         Kurze Information ⁿber die
  716.                                                   Applikation, bis zu 2 Zeilen
  717.                                                   mit je 60 Zeichen.
  718.      
  719.      TRCA_Version            Zeichenkette         Die Interne Version der
  720.                                                   Applikation.
  721.      
  722.      TRCA_Release            Zeichenkette         Die Release-Version der
  723.                                                   Applikation.
  724.      
  725.      TRCA_Date               Zeichenkette         Das Erstellungsdatum der
  726.                                                   Applikation, sollte im
  727.                                                   Standard-Fromat fⁿr Datum
  728.                                                   im Versions-String angegeben
  729.                                                   werden.
  730.  
  731. FUNKTIONEN
  732.      Siehe TR_CreateApp().
  733.  
  734. DEFINITIONEN
  735.      -/-
  736.  
  737. Eigenschaften von Fenstern
  738. **************************
  739.  
  740. ATTRIBUTE
  741.      Kennung                 Datenangabe          Beschreibung
  742.      --------------------------------------------------------------------------
  743.      TRWI_Title              Zeichenkette         Fenstertitel (verΣnderbar)
  744.      
  745.      TRWI_ScreenTitle        Zeichenkette         Bildschirmtitel bei aktivem
  746.                                                   Fenster (verΣnderbar)
  747.      
  748.      TRWI_Flags              Flags
  749.      
  750.                              TRWF_BACKDROP        Rahmenloses Hintergrundfenster
  751.                                                   mit voller Bildschirmgr÷▀e
  752.                              TRWF_NODRAGBAR       Nicht verschiebbar
  753.                              TRWF_NODEPTHGADGET   Kann nich nach vorne oder
  754.                                                   hinten bewegt werden
  755.                              TRWF_NOCLOSEGADGET   Ohne Schlie▀symbol
  756.                              TRWF_NOACTIVATE      Nicht aktiviert
  757.                              TRWF_NOESCCLOSE      Kann nicht mit ESC
  758.                                                   geschlossen werden
  759.                              TRWF_NOPSCRFALLBACK  Nicht ÷ffnen wenn der
  760.                                                   angegebene Bildschirm nicht
  761.                                                   existiert
  762.                              TRWF_NOZIPGADGET     Kein Zoom-Symbol
  763.                              TRWF_ZIPCENTERTOP    Gezoomtes Fenster in der Mitte
  764.                                                   der Titelzeile des Bildschirms
  765.                              TRWF_NOMINTEXTWIDTH  Fenstertitel bestimmt nicht
  766.                                                   die Breite des Fensters
  767.                              TRWF_NOSIZEGADGET    Kein Gr÷▀enverΣnderungs-Symbol
  768.                              TRWF_NOFONTFALLBACK  Bei zu gro▀em Font nicht
  769.                                                   topaz.font 8 verwenden
  770.                              TRWF_NODELZIP        Fenster bei DELETE
  771.                                                   nicht zoomen
  772.                              TRWF_ZIPTOCURRENTPOS Fensterposition bleibt beim
  773.                                                   Zoomen gleich
  774.                              TRWF_APPWINDOW       Auf das Fenster kann man Icons
  775.                                                   fallen lassen
  776.                              TRWF_ACTIVATESTRGAD  Das erste Texteingabefeld im
  777.                                                   Fenster wird sofort aktiviert
  778.                              TRWF_HELP            Das Fenster sendet 'TRMS_HELP'
  779.                                                   wenn ⁿber einem Menⁿ oder
  780.                                                   Objekt HELP gedrⁿckt wird
  781.                              TRWF_SYSTEMACTION    Bei Diskettenwechsel sendet
  782.                                                   das Fenster eine Nachricht:
  783.                                                   'TRMS_DISKINSERTED'
  784.                                                   'TRMS_DISKREMOVED'
  785.      
  786.      TRWI_Underscore         Zeichenkette         Zeichen, mit dem die Hotkeys
  787.                                                   markiert sind, Standard '_'
  788.      
  789.      TRWI_Position           Fensterposition
  790.      
  791.                              TRWP_DEFAULT         La▀ dich ⁿberraschen ;-)
  792.                              TRWP_BELOWTITLEBAR   Links unter der Titelzeile
  793.                                                   des Bildschirms
  794.                              TRWP_CENTERTOP       Zentriert, ganz oben auf
  795.                                                   dem Bildschirm
  796.                              TRWP_TOPLEFTSCREEN   In der linken oberen Ecke
  797.                                                   des Bildschirms
  798.                              TRWP_CENTERSCREEN    Zentriert auf dem Bildschirm
  799.                              TRWP_CENTERDISPLAY   Zentriert im dargestellten
  800.                                                   Bildschirmausschnitt
  801.                              TRWP_MOUSEPOINTER    Zentriert unter dem Mauszeiger
  802.      
  803.      TRWI_CustomScreen       Zeiger               Eigener Bilschirm, auf dem
  804.                                                   das Fenster ge÷ffnet werden
  805.                                                   soll
  806.      
  807.      TRWI_PubScreen          Zeiger               ╓ffentlicher Bildschirm,
  808.                                                   auf dem das Fenster ge÷ffnet
  809.                                                   werden soll
  810.      
  811.      TRWI_PubScreenName      Zeichenkette         Namen eines ÷ffentlichen
  812.                                                   Bildschirms, auf dem das
  813.                                                   Fenster ge÷ffnet wereden
  814.                                                   soll
  815.      
  816.      TRWI_PropFontAttr       TextAttr             Stem-Variable, die eine
  817.                                                   TextAttr-Struktur fⁿr den
  818.                                                   Proportional-Font des
  819.                                                   Fensters enthΣlt
  820.                                                   Siehe Taglisten verwenden.
  821.      
  822.      TRWI_FixedWidthFontAttr TextAttr             Stem-Variable, die eine
  823.                                                   TextAttr-Struktur fⁿr den
  824.                                                   Font mit fester Breite des
  825.                                                   Fensters enthΣlt
  826.                                                   Siehe Taglisten verwenden.
  827.      
  828.      TRWI_Backfill           Fⁿllmuster           Siehe Fⁿllmuster fⁿr Fenster.
  829.      
  830.      TRWI_ID                 Integer              ID-Nummer des Fensters,
  831.                                                   gleichartige Fenster sollten
  832.                                                   gleiche Nummern haben, sonst
  833.                                                   immer verschiedene
  834.      
  835.      TRWI_Dimensions         Dimensionen          Stem-Variable, die eine
  836.                                                   TR_Dimensions-Struktur enthΣlt.
  837.                                                   Nach dem Schlie▀en des Fensters
  838.                                                   enthalten die Felder der hier
  839.                                                   angegebenen Variablen die letzte
  840.                                                   Position und Gr÷▀e des Fensters.
  841.                                                   Siehe Taglisten verwenden.
  842.      
  843.      TRWI_QuickHelp          Bool                 QuickHelp ein/ausschalten
  844.  
  845. FUNKTIONEN
  846.     WindowTitle(title)
  847.           Fenstertitel angeben
  848.  
  849.     ScreenTitle(title)
  850.           Bildschirmtitel angeben
  851.  
  852.     WindowID(id)
  853.           ID-Nummer angeben
  854.  
  855.     WindowFlags(flags)
  856.           Flags angeben
  857.  
  858.     WindowPosition(position)
  859.           Fensterposition angeben
  860.  
  861.     WindowUnderscore(underscore)
  862.           Zeichen angeben, mit dem die Hotkeys markiert sind
  863.  
  864.     WindowDimensions(TR_Dimensions)
  865.           Fensterdimensionen angeben
  866.  
  867.     CustomScreen(screen)
  868.           Zeiger auf einen eigenen Bildschirm
  869.  
  870.     PubScreen(screen)
  871.           Zeiger auf einen ╓ffentlichen Bildschirm
  872.  
  873.     PubScreenName(screenname)
  874.           Name eines ÷ffentlichen Bildschirms
  875.  
  876.     QuickHelpOn(bool)
  877.           QuickHelp ein/ausschalten
  878.  
  879.     BeginRequester(title,position)
  880.           Markiert den Beginn eines Fensters, das mit dem Aussehen eines
  881.           Requesters ge÷ffnet werden soll
  882.  
  883. DEFINITIONEN
  884.     EndProject
  885.           Markiert das Ende einer Projekt-Tagliste
  886.  
  887.     BeginRequesterGads
  888.           Markiert den Beginn der Gadgets im unteren Teil eines Requesters
  889.  
  890.     EndRequester
  891.           Markiert das Ende eines Requesters
  892.  
  893.      Siehe Fⁿllmuster fⁿr Fenster.
  894.  
  895. Menⁿs anlegen
  896. *************
  897.  
  898. ATTRIBUTE
  899.      Kennung                 Datenangabe          Beschreibung
  900.      --------------------------------------------------------------------------
  901.      TRMN_Title              Zeichenkette         Menⁿtitel
  902.      
  903.      TRMN_Item               Zeichenkette         Ein Menⁿpunkt in dem zuvor
  904.                                                   angegebenen Menⁿ. Eine Taste
  905.                                                   kann angegeben werden indem
  906.                                                   man das gewⁿnschte Zeichen
  907.                                                   dem Text voranstellt, gefolgt
  908.                                                   von '_' und schlie▀lich dem
  909.                                                   Text. Steuertasten  k÷nnen
  910.                                                   genauso angegeben werden,
  911.                                                   jedoch mu▀ das erste Zeichen
  912.                                                   ein '_' sein.
  913.      
  914.                                                   S_Datei speichern
  915.                                                   D_Drucken
  916.      
  917.                                                   _F1_Text anzeigen
  918.                                                   _Delete_L÷schen
  919.      
  920.                                                   Wenn als Text 'TRMN_BARLABEL'
  921.                                                   angegeben wird, dann ist der
  922.                                                   Menⁿpunkt eine Trennlinie.
  923.      
  924.      TRMN_Sub                Zeichenkette         Ein Untermenⁿpunkt zu dem
  925.                                                   zuvor angegebenen Menⁿpunkt.
  926.                                                   Hier gilt das gleiche wie bei
  927.                                                   'TRMN_Item'.
  928.      
  929.      TRMN_Flags              Flags
  930.      
  931.                              TRMF_CHECKIT         Ein Menⁿpunkt zum abhaken
  932.                              TRMF_CHECKED         Der Menⁿpunkt ist abgehakt
  933.                              TRMF_DISABLED        Nicht anwΣhlbar
  934.      
  935.      TRAT_ID                 Integer              ID-Nummer eines Menⁿpunkts
  936.  
  937. FUNKTIONEN
  938.     BeginMenu(title)
  939.           Beginn eines neuen Menⁿs
  940.  
  941.     MenuFlags(flags)
  942.           Menⁿ-Flags angeben
  943.  
  944.     MenuItem(text,id)
  945.           Ein normaler Menⁿpunkt
  946.  
  947.     MenuItemC(text,id)
  948.           Ein Menⁿpunkt zum abhaken
  949.  
  950.     MenuItemCC(text,id)
  951.           Ein abgehakter Menⁿpunkt
  952.  
  953.     MenuItemD(text,id)
  954.           Ein normaler Menⁿpunkt, nicht anwΣhlbar
  955.  
  956.     BeginSub(title)
  957.           Beginn eines Untermenⁿs
  958.  
  959.     SubItem(text,id)
  960.           Ein Untermenⁿpunkt
  961.  
  962.     SubItemD(text,id)
  963.           Ein Untermenⁿpunkt, nicht anwΣhlbar
  964.  
  965. DEFINITIONEN
  966.     ItemBarlabel
  967.           Eine Trennline im Menⁿ
  968.  
  969.     SubBarlabel
  970.           Eine Trennline im Untermenⁿ
  971.  
  972. Objekte und Attribute
  973. *********************
  974.  
  975. Alle Bestandteile eines Fensters nennt man Objekte. Folgende Liste enthΣlt
  976. alle verfⁿgbaren Objekte mit den dazu geh÷renden Eigenschaften:
  977.  
  978.  
  979. Objekte, die Aktionen ausl÷sen
  980.  
  981. * Button                 - Einfache Kn÷pfe
  982. * CheckBox               - Ein/Aus Schalter
  983. * Cycle                  - Felder zur Mehrfachauswahl
  984. * DropBox                - FlΣchen zum Fallenlassen von Icons
  985. * Listview               - Listen zur Darstellung und Auswahl
  986. * Palette                - Auswahl von Farben
  987. * Scroller               - Schieberegler zum Scrollen durch Listen
  988. * Slider                 - Schieberegler zur Einstellung von Werten
  989. * String                 - Texteingabefelder
  990.  
  991. Grafische Objekte
  992.  
  993. * FrameBox               - Einrahmen von Gruppen
  994. * Group                  - Gruppen
  995. * Image                  - Grafiken
  996. * Line                   - Trennlinien
  997. * Progress               - Fortschritt von Arbeiten anzeigen
  998. * Space                  - LeerrΣume zwischen Objekten
  999. * Text                   - Texte in verschiedenen Darstellungsarten
  1000.  
  1001. Sonstiges
  1002.  
  1003. * QuickHelp              - Kurzhilfe
  1004. * Fⁿllmuster fⁿr Fenster - Fensterhintergrund fⁿllen
  1005. * Fⁿllmuster fⁿr Objekte - Objekthintergrund fⁿllen
  1006.  
  1007. Button
  1008. ******
  1009.  
  1010. OBJEKTNAME
  1011.      TROB_Button
  1012.  
  1013. ATTRIBUTE
  1014.      Kennung                 Datenangabe       Beschreibung
  1015.      ---------------------------------------------------------------------
  1016.      TROB_Button             Typ
  1017.      
  1018.                              TRBT_TEXT         Einfacher Knopf mit Text
  1019.                              TRBT_GETFILE      Datei-Request-Knopf
  1020.                              TRBT_GETDRAWER    Verzeichnis-Rquest-Knopf
  1021.                              TRBT_GETENTRY     Listen-Auswahl-Knopf
  1022.      
  1023.      TRAT_Disabled           Bool              Knopf anwΣhlbar?
  1024.      
  1025.      TRAT_Flags              Flags
  1026.      
  1027.                              TRBU_RETURNOK     Anwahl auch mit RETURN
  1028.                              TRBU_ESCOK        Anwahl auch mit ESC
  1029.                              TRBU_SHIFTED      Tastatur nur mit SHIFT
  1030.                              TRBU_UNSHIFTED    Tastatur nur ohne SHIFT
  1031.                              TRBU_YRESIZE      Vertikal skalierbar
  1032.      
  1033.      TRAT_ID                 Integer           ID-Nummer des Knopfs
  1034.      
  1035.      TRAT_Text               Zeichenkette      Text fⁿr den Knopf
  1036.      
  1037.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1038.  
  1039. FUNKTIONEN
  1040.     Button(text,id)
  1041.           Einfacher Knopf
  1042.  
  1043.     ButtonR(text,id)
  1044.           Einfacher Knopf, kann mit RETURN angewΣhlt werden
  1045.  
  1046.     ButtonE(text,id)
  1047.           Einfacher Knopf, kann mit ESC angewΣhlt werden
  1048.  
  1049.     ButtonRE(text,id)
  1050.           Einfacher Knopf, kann mit RETURN und ESC angewΣhlt werden
  1051.  
  1052.     CenteredButton(text,id)
  1053.           Wie 'Button()', nur zentriert
  1054.  
  1055.     CenteredButtonR(text,id)
  1056.           Wie 'ButtonR()', nur zentriert
  1057.  
  1058.     CenteredButtonE(text,id)
  1059.           Wie 'ButtonE()', nur zentriert
  1060.  
  1061.     CenteredButtonRE(text,id)
  1062.           Wie 'ButtonRE()', nur zentriert
  1063.  
  1064.     EmptyButton(id)
  1065.           Ein Knopf ohne Text
  1066.  
  1067.     GetFileButton(id)
  1068.           Ein Datei-Request-Knopf
  1069.  
  1070.     GetDrawerButton(id)
  1071.           Ein Verzeichnis-Request-Knopf
  1072.  
  1073.     GetEntryButton(id)
  1074.           Ein Listen-Auswahl-Knopf
  1075.  
  1076.     GetFileButtonS(s,id)
  1077.           Wie 'GetFileButton()', nur mit Text
  1078.  
  1079.     GetDrawerButtonS(s,id)
  1080.           Wie 'GetDrawerButton()', nur mit Text
  1081.  
  1082.     GetEntryButtonS(s,id)
  1083.           Wie 'GetEntryButton()', nur mit Text
  1084.  
  1085. DEFINITIONEN
  1086.      -/-
  1087.  
  1088. CheckBox
  1089. ********
  1090.  
  1091. OBJEKTNAME
  1092.      TROB_CheckBox
  1093.  
  1094. ATTRIBUTE
  1095.      Kennung                 Datenangabe       Beschreibung
  1096.      ---------------------------------------------------------------------
  1097.      TROB_CheckBox           Ungenutzt
  1098.      
  1099.      TRAT_Disabled           Bool              Schalter anwΣhlbar?
  1100.      
  1101.      TRAT_ID                 Integer           ID-Nummer des Schalters
  1102.      
  1103.      TRAT_Value              Bool              Eingeschaltet?
  1104.      
  1105.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1106.  
  1107. FUNKTIONEN
  1108.     CheckBox(id)
  1109.           Einfacher Schalter, abgeschaltet
  1110.  
  1111.     CheckBoxC(id)
  1112.           Einfacher Schalter, eingeschaltet
  1113.  
  1114.     CheckBoxLEFT(id)
  1115.           Wie 'CheckBox()', nur linksbⁿndig
  1116.  
  1117.     CheckBoxCLEFT(id)
  1118.           Wie 'CheckBoxC()', nur linksbⁿndig
  1119.  
  1120. DEFINITIONEN
  1121.      -/-
  1122.  
  1123. Cycle
  1124. *****
  1125.  
  1126. OBJEKTNAME
  1127.      TROB_Cycle
  1128.  
  1129. ATTRIBUTE
  1130.      Kennung                 Datenangabe       Beschreibung
  1131.      ---------------------------------------------------------------------
  1132.      TROB_Cycle              EintrΣge          Stem-Variable, die die
  1133.                                                anwΣhlbaren EintrΣge enthΣlt
  1134.      
  1135.      TRAT_Disabled           Bool              Auswahlfeld anwΣhlbar?
  1136.                                                (Radio-Buttons nur ab OS3.0)
  1137.      
  1138.      TRAT_Flags              Flags
  1139.      
  1140.                              TRCY_MX           Darstellung als Radio-Buttons
  1141.                              TRCY_RIGHTLABELS  Texte rechts von den Kn÷pfen
  1142.      
  1143.      TRAT_ID                 Integer           ID-Nummer des Auswahlfeldes
  1144.      
  1145.      TRAT_Value              Integer           Nummer des angewΣhlten
  1146.                                                Eintrags
  1147.      
  1148.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1149.  
  1150. FUNKTIONEN
  1151.     CycleGadget(eintrΣge,value,id)
  1152.           Einfaches Auswahlfeld
  1153.  
  1154.     MXGadget(eintrΣge,value,id)
  1155.           Auswahlfeld als Radio-Buttons
  1156.  
  1157.     MXGadgetR(eintrΣge,value,id)
  1158.           Wie 'MXGadget()', Texte rechts von den Kn÷pfen
  1159.  
  1160. DEFINITIONEN
  1161.      -/-
  1162.  
  1163. DropBox
  1164. *******
  1165.  
  1166. OBJEKTNAME
  1167.      TROB_DropBox
  1168.  
  1169. ATTRIBUTE
  1170.      Kennung                 Datenangabe       Beschreibung
  1171.      ---------------------------------------------------------------------
  1172.      TROB_DropBox            Ungenutzt
  1173.      
  1174.      TRAT_Disabled           Bool              Dorpbox benutzbar?
  1175.      
  1176.      TRAT_ID                 Integer           ID-Nummer der Dropbox
  1177.      
  1178.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1179.  
  1180. FUNKTIONEN
  1181.     DropBox(id)
  1182.           Einfache Dropbox
  1183.  
  1184. DEFINITIONEN
  1185.      -/-
  1186.  
  1187. Listview
  1188. ********
  1189.  
  1190. OBJEKTNAME
  1191.      TROB_Listview
  1192.  
  1193. ATTRIBUTE
  1194.      Kennung                Datenangabe       Beschreibung
  1195.      -----------------------------------------------------------------------
  1196.      TROB_Listview          EintrΣge           Stem-Variable, die die
  1197.                                                EintrΣge der Liste enthΣlt
  1198.      
  1199.      TRAT_Disabled          Bool               Listview aktiv?
  1200.      
  1201.      TRAT_Flags             Flags
  1202.      
  1203.                             Typ, diese Flags schlie▀en sich gegenseitig aus
  1204.                             ------------------------------------------------
  1205.                             TRLV_READONLY      Liste ist nur lesbar
  1206.                             TRLV_SELECT        Auswahl m÷glich
  1207.                             TRLV_SHOWSELECTED  AusgewΣhlter Eintrag wird
  1208.                                                markiert
  1209.      
  1210.                             Sonstige Flags
  1211.                             ------------------------------------------------
  1212.                             TRLV_NOCURSORKEYS  Cursortasten nicht verwenden
  1213.                             TRLV_NONUMPADKEYS  Zehnerblock nicht verwenden
  1214.                             TRLV_FWFONT        Zeichensatz mit fester Breite
  1215.                             TRLV_NOGAP         Kein Leerraum unter der Liste,
  1216.                                                stattdessen am Ende der Gruppe
  1217.      
  1218.      
  1219.      TRAT_ID                Integer            ID-Nummer des Listviews
  1220.      
  1221.      TRAT_MinWidth          Integer            Minimale Breite in Zeichen
  1222.                                                (Standard sind 10 Zeichen)
  1223.      
  1224.      TRAT_MinHeight         Integer            Minimale H÷he in Zeilen
  1225.                                                (Standard sind 4 Zeilen)
  1226.      
  1227.      TRAT_Value             Integer            Nummer des ausgewΣhlten Eintrags
  1228.                                                der erste Eintrag ist 0!!!
  1229.      
  1230.      TRLV_Top               Integer            Nummer des obersten Eintrags
  1231.                                                in der Anzeige
  1232.      
  1233.      TRDO_QuickHelpString   Zeichenkette       Kurzer Hilfstext
  1234.  
  1235. FUNKTIONEN
  1236.     ListRO(eintrΣge,id,top)
  1237.           Einfache Liste, nur lesbar
  1238.  
  1239.     ListSel(eintrΣge,id,top)
  1240.           Einfache Liste, EintrΣge auswΣhlbar
  1241.  
  1242.     ListSS(eintrΣge,id,top,value)
  1243.           Einfache Liste, ausgewΣhlter Eintrag wird markiert
  1244.  
  1245.     ListROC(eintrΣge,id,top)
  1246.           Wie 'ListRO()', keine Steuerung mit den Cursortasten
  1247.  
  1248.     ListSelC(eintrΣge,id,top)
  1249.           Wie 'ListSel()', keine Steuerung mit den Cursortasten
  1250.  
  1251.     ListSSC(eintrΣge,id,top,value)
  1252.           Wie 'ListSS()', keine Steuerung mit den Cursortasten
  1253.  
  1254.     ListRON(eintrΣge,id,top)
  1255.           Wie 'ListRO()', keine Steuerung mit dem Zehnerblock
  1256.  
  1257.     ListSelN(eintrΣge,id,top)
  1258.           Wie 'ListSel()', keine Steuerung mit dem Zehnerblock
  1259.  
  1260.     ListSSN(eintrΣge,id,top,value)
  1261.           Wie 'ListSS()', keine Steuerung mit dem Zehnerblock
  1262.  
  1263.     ListROCN(eintrΣge,id,top)
  1264.           Wie 'ListRO()', keine Steuerung mit den Cursortasten und dem
  1265.           Zehnerblock
  1266.  
  1267.     ListSelCN(eintrΣge,id,top)
  1268.           Wie 'ListSel()', keine Steuerung mit den Cursortasten und dem
  1269.           Zehnerblock
  1270.  
  1271.     ListSSCN(eintrΣge,id,top,value)
  1272.           Wie 'ListSS()', keine Steuerung mit den Cursortasten und dem
  1273.           Zehnerblock
  1274.  
  1275.      ---------------------------------------------------------------------
  1276.  
  1277.     FWListRO(eintrΣge,id,top)
  1278.           Wie 'ListRO()', Zeichensatz mit fester Breite
  1279.  
  1280.     FWListSel(eintrΣge,id,top)
  1281.           Wie 'ListSel()', Zeichensatz mit fester Breite
  1282.  
  1283.     FWListSS(eintrΣge,id,top,value)
  1284.           Wie 'ListSS()', Zeichensatz mit fester Breite
  1285.  
  1286.     FWListROC(eintrΣge,id,top)
  1287.           Wie 'ListROC()', Zeichensatz mit fester Breite
  1288.  
  1289.     FWListSelC(eintrΣge,id,top)
  1290.           Wie 'ListSelC()', Zeichensatz mit fester Breite
  1291.  
  1292.     FWListSSC(eintrΣge,id,top,value)
  1293.           Wie 'ListSSC()', Zeichensatz mit fester Breite
  1294.  
  1295.     FWListRON(eintrΣge,id,top)
  1296.           Wie 'ListRON()', Zeichensatz mit fester Breite
  1297.  
  1298.     FWListSelN(eintrΣge,id,top)
  1299.           Wie 'ListSelN()', Zeichensatz mit fester Breite
  1300.  
  1301.     FWListSSN(eintrΣge,id,top,value)
  1302.           Wie 'ListSSN()', Zeichensatz mit fester Breite
  1303.  
  1304.     FWListROCN(eintrΣge,id,top)
  1305.           Wie 'ListROCN()', Zeichensatz mit fester Breite
  1306.  
  1307.     FWListSelCN(eintrΣge,id,top)
  1308.           Wie 'ListSelCN()', Zeichensatz mit fester Breite
  1309.  
  1310.     FWListSSCN(eintrΣge,id,top,value)
  1311.           Wie 'ListSSCN()', Zeichensatz mit fester Breite
  1312.  
  1313. DEFINITIONEN
  1314.      -/-
  1315.  
  1316. Palette
  1317. *******
  1318.  
  1319. OBJEKTNAME
  1320.      TROB_Palette
  1321.  
  1322. ATTRIBUTE
  1323.      Kennung                 Datenangabe       Beschreibung
  1324.      ---------------------------------------------------------------------
  1325.      TROB_Palette            Ungenutzt
  1326.      
  1327.      TRAT_Disabled           Bool              Palette anwΣhlbar?
  1328.      
  1329.      TRAT_ID                 Integer           ID-Nummer der Palette
  1330.      
  1331.      TRAT_Value              Integer           Nummer der ausgewΣhlten
  1332.                                                Farbe
  1333.      
  1334.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1335.  
  1336. FUNKTIONEN
  1337.     PaletteGadget(value,id)
  1338.           Einfache Palette zur Farbauswahl
  1339.  
  1340. DEFINITIONEN
  1341.      -/-
  1342.  
  1343. Scroller
  1344. ********
  1345.  
  1346. OBJEKTNAME
  1347.      TROB_Scroller
  1348.  
  1349. ATTRIBUTE
  1350.      Kennung                 Datenangabe       Beschreibung
  1351.      ---------------------------------------------------------------------
  1352.      TROB_Scroller           Flags
  1353.      
  1354.                              TROF_HORIZ        Horizontaler Scroller
  1355.                              TROF_VERT         Vertikaler Scroller
  1356.      
  1357.      TRAT_Disabled           Bool              Scroller anwΣhlbar?
  1358.      
  1359.      TRAT_ID                 Integer           ID-Nummer des Scrollers
  1360.      
  1361.      TRAT_Value              Integer           Nummer des ersten sichtbaren
  1362.                                                Eintrags der Liste, die der
  1363.                                                Scroller steuert
  1364.      
  1365.      TRSC_Total              Integer           Gesamtanzahl der EintrΣge der
  1366.                                                Liste, die der Scroller steuert
  1367.      
  1368.      TRSC_Visible            Integer           Anzahl der sichtbaren EintrΣge
  1369.                                                der Liste, die der Regler steuert
  1370.      
  1371.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1372.  
  1373. FUNKTIONEN
  1374.      -/-
  1375.  
  1376. DEFINITIONEN
  1377.      -/-
  1378.  
  1379. Slider
  1380. ******
  1381.  
  1382. OBJEKTNAME
  1383.      TROB_Slider
  1384.  
  1385. ATTRIBUTE
  1386.      Kennung                 Datenangabe       Beschreibung
  1387.      ---------------------------------------------------------------------
  1388.      TROB_Slider             Flags
  1389.      
  1390.                              TROF_HORIZ        Horizontaler Schieberegler
  1391.                              TROF_VERT         Vertikaler Schieberegler
  1392.      
  1393.      TRAT_Disabled           Bool              Schieberegler anwΣhlbar?
  1394.      
  1395.      TRAT_ID                 Integer           ID-Nummer des Schiebereglers
  1396.      
  1397.      TRAT_Value              Integer           Anzuzeigender Wert
  1398.      
  1399.      TRSL_Min                Integer           Kleinster einstellbarer Wert
  1400.      
  1401.      TRSL_Max                Integer           Gr÷▀ter einstellbarer Wert
  1402.      
  1403.      TRDO_QuickHelpString    Zeichenkette      Kurzer Hilfstext
  1404.  
  1405. FUNKTIONEN
  1406.     SliderGadget(minimum,maximum,value,id)
  1407.           Einfacher, horizontaler Schieberegler
  1408.  
  1409. DEFINITIONEN
  1410.      -/-
  1411.  
  1412. WICHTIG
  1413.      Mit Slider-Gadgets k÷nnen in der aktuellen Version keine negativen
  1414.      Zahlen eingestellt werden. Falls sich die Verwendung von negativen
  1415.      Zahlen nicht vermeiden lΣ▀t kann man sich mit einem Trick behelfen.
  1416.      Man wΣhlt einen Einstellbereich von '0 bis Maximalwert-Minimalwert',
  1417.      der angezeigte Wert errechnet sich dann aus 'SliderValue+Minimalwert'.
  1418.  
  1419.      Beispiel:
  1420.      ---------
  1421.         minimum = -128
  1422.         maximum =  127
  1423.         wert    = -100
  1424.      
  1425.      Slider erstellen:
  1426.      -----------------
  1427.         SliderGadget(0,maximum-minimum,wert+minimum,1)
  1428.      
  1429.      Anzuzeigenden Wert ermitteln:
  1430.      -----------------------------
  1431.         wert = TR_GETATTRIBUTE(project,1,'TRAT_Value')+minimum
  1432.      
  1433.      Wert aus einer 'TRMS_NEWVALUE-Nachricht' auslesen:
  1434.      --------------------------------------------------
  1435.         wert = stemvar.trm_data+minimum
  1436.  
  1437. String
  1438. ******
  1439.  
  1440. OBJEKTNAME
  1441.      TROB_String
  1442.  
  1443. ATTRIBUTE
  1444.      Kennung               Datenangabe            Beschreibung
  1445.      ---------------------------------------------------------------------
  1446.      TROB_String           Zeichenkette           Der zu edierende Text
  1447.      
  1448.      TRAT_Disabled         Bool                   Eingabefeld aktivierbar?
  1449.      
  1450.      TRAT_Flags            Flags
  1451.      
  1452.                            TRST_INVISIBLE         Die Eingabe ist nicht
  1453.                                                   sichtbar (Passwort)
  1454.                            TRST_NORETURNBROADCAST RETURN-Meldung nicht
  1455.                                                   weiterreichen
  1456.      
  1457.      TRAT_ID               Integer                ID-Nummer des Eingabefeldes
  1458.      
  1459.      TRAT_Value            Integer                Maximale Anzahl Zeichen
  1460.      
  1461.      TRDO_QuickHelpString  Zeichenkette           Kurzer Hilfstext
  1462.  
  1463. FUNKTIONEN
  1464.     StringGadget(defaultstring,id)
  1465.           Ein normales Texteingabefeld
  1466.  
  1467.     PasswordGadget(defaultstring,id)
  1468.           Ein Eingabefeld fⁿr Passw÷rter
  1469.  
  1470. DEFINITIONEN
  1471.      -/-
  1472.  
  1473. FrameBox
  1474. ********
  1475.  
  1476. OBJEKTNAME
  1477.      TROB_FrameBox
  1478.  
  1479. ATTRIBUTE
  1480.      Kennung              Datenangabe             Beschreibung
  1481.      ---------------------------------------------------------------------
  1482.      TROB_FrameBox        Typ
  1483.      
  1484.                           TRFB_TEXT               Rahmen fⁿr eine Textbox
  1485.                           TRFB_GROUPING           Ein Gruppen-Rahmen
  1486.                           TRFB_FRAMING            Einrahmung einer Gruppe
  1487.      
  1488.      TRAT_Backfill        Fⁿllmuster              Siehe Fⁿllmuster fⁿr Objekte.
  1489.      
  1490.      TRAT_ID              Integer                 ID-Nummer des Rahmens
  1491.      
  1492.      TRAT_Text            Zeichenkette            Text fⁿr den Rahmen
  1493.  
  1494.      Es wird nur das nachfolgende Objekt eingerahmt. Wenn eine ganze Gruppe
  1495.      eingerahmt werden soll mu▀ also das erste Objekt nach der FrameBox die
  1496.      einzurahmende Gruppe sein. Siehe Group.
  1497.  
  1498. FUNKTIONEN
  1499.     NamedFrameBox(text)
  1500.           Einrahmung einer Gruppe mit Text als ▄berschrift
  1501.  
  1502.     TextBox(text,id,minwidth)
  1503.           Eine Textbox mit mindestens 'minwidth' Zeichen Breite
  1504.  
  1505. DEFINITIONEN
  1506.     GroupBox
  1507.           Einfacher Gruppenrahmen
  1508.  
  1509. Group
  1510. *****
  1511.  
  1512. OBJEKTNAME
  1513.      TRGR_Horiz TRGR_Vert
  1514.  
  1515. ATTRIBUTE
  1516.      Kennung                 Datenangabe       Beschreibung
  1517.      --------------------------------------------------------------------------
  1518.      TRGR_Horiz              Flags             Siehe OberflΣchen erstellen.
  1519.      TRGR_Vert               Flags             Siehe OberflΣchen erstellen.
  1520.      
  1521.                              TRGR_PROPSHARE    Objekte proportional anordnen
  1522.                              TRGR_EQUALSHARE   Objekte gleichmΣ▀ig anordnen
  1523.                              TRGR_PROPSPACES   LeerrΣume skalieren
  1524.                              TRGR_ARRAY        Tabelle von Objekten
  1525.                              TRGR_ALIGN        Objekte aneinander anpassen
  1526.                              TRGR_CENTER       Objekte zueinander zentrieren
  1527.                              TRGR_FIXHORIZ     Gruppe mit fester Breite
  1528.                              TRGR_FIXVERT      Gruppe mit fester H÷he
  1529.                              TRGR_INDEP        Gruppe ist von der ⁿbergeordneten
  1530.                                                Tabelle unabhΣngig
  1531.      
  1532.      TRAT_ID                 Integer           ID-Nummer der Gruppe
  1533.      
  1534.      TRGR_End                Ungenutzt         Markiert das Ende einer Gruppe
  1535.  
  1536. FUNKTIONEN
  1537.      -/-
  1538.  
  1539. DEFINITIONEN
  1540.     HorizGroup
  1541.           Einfache horizontale Gruppe
  1542.  
  1543.     HorizGroupE
  1544.           Horizontale Gruppe, alle Objekte haben die gleiche Breite
  1545.  
  1546.     HorizGroupS
  1547.           Horizontale Gruppe, alle Objekte haben die minimale Breite,
  1548.           LeerrΣume werden skaliert
  1549.  
  1550.     HorizGroupA
  1551.           Horizontale Gruppe, alle Objekte haben die gleiche H÷he
  1552.  
  1553.     HorizGroupC
  1554.           Horizontale Gruppe, alle Objekte werden vertikal zentriert
  1555.           angeordnet
  1556.  
  1557.     HorizGroupEA
  1558.           Kombination aus 'HorizGroupE' und 'HorizGroupA'
  1559.  
  1560.     HorizGroupSA
  1561.           Kombination aus 'HorizGroupS' und 'HorizGroupA'
  1562.  
  1563.     HorizGroupEC
  1564.           Kombination aus 'HorizGroupE' und 'HorizGroupC'
  1565.  
  1566.     HorizGroupSC
  1567.           Kombination aus 'HorizGroupS' und 'HorizGroupC'
  1568.  
  1569.     HorizGroupAC
  1570.           Kombination aus 'HorizGroupA' und 'HorizGroupC'
  1571.  
  1572.     HorizGroupEAC
  1573.           Kombination aus 'HorizGroupE', 'HorizGroupA' und 'HorizGroupC'
  1574.  
  1575.     HorizGroupSAC
  1576.           Kombination aus 'HorizGroupS', 'HorizGroupA' und 'HorizGroupC'
  1577.  
  1578.      ---------------------------------------------------------------------
  1579.  
  1580.     VertGroup
  1581.           Einfache vertikale Gruppe
  1582.  
  1583.     VertGroupE
  1584.           Vertikale Gruppe, alle Objekte haben die gleiche H÷he
  1585.  
  1586.     VertGroupS
  1587.           Vertikale Gruppe, alle Objekte haben die minimale H÷he, LeerrΣume
  1588.           werden skaliert
  1589.  
  1590.     VertGroupA
  1591.           Vertikale Gruppe, alle Objekte haben die gleiche Breite
  1592.  
  1593.     VertGroupC
  1594.           Vertikale Gruppe, alle Objekte werden horizontal zentriert
  1595.           angeordnet
  1596.  
  1597.     VertGroupEA
  1598.           Kombination aus 'VertGroupE' und 'VertGroupA'
  1599.  
  1600.     VertGroupSA
  1601.           Kombination aus 'VertGroupS' und 'VertGroupA'
  1602.  
  1603.     VertGroupEC
  1604.           Kombination aus 'VertGroupE' und 'VertGroupC'
  1605.  
  1606.     VertGroupSC
  1607.           Kombination aus 'VertGroupS' und 'VertGroupC'
  1608.  
  1609.     VertGroupAC
  1610.           Kombination aus 'VertGroupA' und 'VertGroupC'
  1611.  
  1612.     VertGroupEAC
  1613.           Kombination aus 'VertGroupE', 'VertGroupA' und 'VertGroupC'
  1614.  
  1615.     VertGroupSAC
  1616.           Kombination aus 'VertGroupS', 'VertGroupA' und 'VertGroupC'
  1617.  
  1618.      ---------------------------------------------------------------------
  1619.  
  1620.     EndGroup
  1621.           Ende einer Gruppe
  1622.  
  1623.     ColumnArray
  1624.           Anfang einer Spalten-Tabelle
  1625.  
  1626.     LineArray
  1627.           Anfang einer Zeilen-Tabelle
  1628.  
  1629.     BeginColumn
  1630.           Anfang einer neuen Spalte innerhalb der Tabelle
  1631.  
  1632.     BeginLine
  1633.           Anfang einer neuen Zeile innerhalb der Tabelle
  1634.  
  1635.     BeginColumnI
  1636.           Anfang einer unabhΣngigen Spalte innerhalb der Tabelle
  1637.  
  1638.     BeginLineI
  1639.           Anfang einer unabhΣngigen Zeile innerhalb der Tabelle
  1640.  
  1641.     EndColumn
  1642.           Ende einer Spalte innerhalb der Tabelle
  1643.  
  1644.     EndLine
  1645.           Ende einer Zeile innerhalb der Tabelle
  1646.  
  1647.     EndArray
  1648.           Ende einer Tabelle
  1649.  
  1650. Image
  1651. *****
  1652.  
  1653. OBJEKTNAME
  1654.      TROB_Image
  1655.  
  1656. ATTRIBUTE
  1657.      Kennung                 Datenangabe       Beschreibung
  1658.      ---------------------------------------------------------------------
  1659.      TROB_Image              Image             Der logische Name einer
  1660.                                                zuvor angelegten Grafik
  1661.                                                Siehe CreateImage().
  1662.      
  1663.      TRAT_Flags              Flags
  1664.      
  1665.                              TRIM_BOOPSI       In der aktuellen Version mu▀
  1666.                                                dieses Flag immer angegeben
  1667.                                                werden, sonst kann es zu
  1668.                                                Abstⁿrzen kommen!
  1669.      
  1670.      TRAT_MinWidth           Integer           Minimale Breite der Grafik
  1671.                                                in Pixel (Standard ist die
  1672.                                                H÷he eines Knopfes)
  1673.      
  1674.      TRAT_MinHeight          Integer           Minimale H÷he der Grafik
  1675.                                                in Pixel (Standard ist die
  1676.                                                H÷he eines Knopfes)
  1677.      
  1678.      TRAT_ID                 Integer           ID-Nummer der Grafik
  1679.  
  1680. FUNKTIONEN
  1681.     BoopsiImage(image)
  1682.           Einfache Grafik
  1683.  
  1684.     BoopsiImageD(image,minwidth,minheight)
  1685.           Einfache Grafik, jedoch mit minimaler Breite und H÷he
  1686.  
  1687. DEFINITIONEN
  1688.      -/-
  1689.  
  1690. Line
  1691. ****
  1692.  
  1693. OBJEKTNAME
  1694.      TROB_Line
  1695.  
  1696. ATTRIBUTE
  1697.      Kennung                 Datenangabe       Beschreibung
  1698.      ---------------------------------------------------------------------
  1699.      TROB_Line               Flags
  1700.      
  1701.                              TROF_HORIZ        Horizontale linie
  1702.                              TROF_VERT         Vertikale linie
  1703.                              TROF_RAISED       Linie ist erhaben
  1704.  
  1705. FUNKTIONEN
  1706.     Line(flags)
  1707.           Einfache Linie
  1708.  
  1709.     NamedSeparator(text)
  1710.           Horizontale Trennlinie mit Leerraum an Anfang und Ende und Text in
  1711.           der Mitte
  1712.  
  1713.     NamedSeparatorI(te,id)
  1714.           WIe 'NamedSeparator()', nur mit ID-Nummer
  1715.  
  1716.     NamedSeparatorN(text)
  1717.           Horizontale Trennlinie mit Text in der Mitte
  1718.  
  1719.     NamedSeparatorIN(te,id)
  1720.           WIe 'NamedSeparatorN()', nur mit ID-Nummer
  1721.  
  1722. DEFINITIONEN
  1723.     HorizSeparator
  1724.           Horizontale Trennlinie mit Leerraum an Anfang und Ende
  1725.  
  1726.     VertSeparator
  1727.           Vertikale Trennlinie mit Leerraum oben und unten
  1728.  
  1729. Progress
  1730. ********
  1731.  
  1732. OBJEKTNAME
  1733.      TROB_Progress
  1734.  
  1735. ATTRIBUTE
  1736.      Kennung                 Datenangabe       Beschreibung
  1737.      ---------------------------------------------------------------------
  1738.      TROB_Progress           Integer           Maximaler Wert,
  1739.                                                z.B. 100 bei Prozentanzeige
  1740.      
  1741.      TRAT_Flags              Flags
  1742.      
  1743.                              TROF_HORIZ        Horizontal (Standard)
  1744.                              TROF_VERT         Vertikal
  1745.      
  1746.      TRAT_ID                 Integer           ID-Nummer
  1747.      
  1748.      TRAT_Value              Integer           Anzuzeigender Wert
  1749.  
  1750. FUNKTIONEN
  1751.     Progress(maximum,value,id)
  1752.           Horizontale Fortschrittsanzeige
  1753.  
  1754. DEFINITIONEN
  1755.      -/-
  1756.  
  1757. Space
  1758. *****
  1759.  
  1760. OBJEKTNAME
  1761.      TROB_Space
  1762.  
  1763. ATTRIBUTE
  1764.      Kennung                 Datenangabe       Beschreibung
  1765.      ---------------------------------------------------------------------
  1766.      TROB_Space              Typ
  1767.      
  1768.                              TRST_NONE         Kein Leerraum
  1769.                              TRST_SMALL        Kleiner Leerraum
  1770.                              TRST_NORMAL       Normaler Leerraum
  1771.                              TRST_BIG          Gro▀er Leerraum
  1772.  
  1773. FUNKTIONEN
  1774.      -/-
  1775.  
  1776. DEFINITIONEN
  1777.     SpaceB
  1778.           Gro▀er Leerraum
  1779.  
  1780.     Space
  1781.           Normaler Leerraum
  1782.  
  1783.     SpaceS
  1784.           Kleiner Leerraum
  1785.  
  1786.     SpaceN
  1787.           Kein Leerraum
  1788.  
  1789. Text
  1790. ****
  1791.  
  1792. OBJEKTNAME
  1793.      TROB_Text
  1794.  
  1795. ATTRIBUTE
  1796.      Kennung                 Datenangabe       Beschreibung
  1797.      ---------------------------------------------------------------------
  1798.      TROB_Text               Ungenutzt
  1799.      
  1800.      TRAT_ID                 Integer           ID-Nummer des Textes
  1801.      
  1802.                              Wenn ein anderes Objekt die gleiche ID besitzt,
  1803.                              und im Text einem Zeichen ein '_' vorangestellt
  1804.                              ist, dann kann das zugeh÷rige Objekt mit der
  1805.                              entsprechenden Taste gesteuert werden.
  1806.      
  1807.      TRAT_Flags              Flags
  1808.      
  1809.                              TRTX_NOUNDERSCORE '_' wird nicht beachtet
  1810.                              TRTX_HIGHLIGHT    Hervorgehobener Text
  1811.                              TRTX_3D           Text mit Schatten
  1812.                              TRTX_BOLD         Fett geschriebener Text
  1813.                              TRTX_TITLE        Titeltext, Attribute wie mit
  1814.                                                'Prefs/Triton' eingestellt
  1815.                              TROF_RIGHTALIGN   Text ist rechtsbⁿndig
  1816.                              TRTX_CLIPPED      Im zugeh÷rigen Bereich nicht
  1817.                                                mehr darstellbarer Text wird
  1818.                                                abgeschnitten
  1819.      
  1820.      TRAT_MinWidth           Integer           Minimale Breite des Textes
  1821.                                                in Zeichen
  1822.      
  1823.      TRAT_Text               Zeichenkette      Der anzuzeigende Text
  1824.      
  1825.      TRAT_Value              Integer           Eine anzuzeigende Zahl
  1826.  
  1827. FUNKTIONEN
  1828.     TextN(text)
  1829.           Normaler Text
  1830.  
  1831.     TextH(text)
  1832.           Hervorgehobener Text
  1833.  
  1834.     Text3(text)
  1835.           Text mit Schatten
  1836.  
  1837.     TextB(text)
  1838.           Fett geschriebener Text
  1839.  
  1840.     TextT(text)
  1841.           Titeltext, Attribute wie mit 'Prefs/Triton' eingestellt
  1842.  
  1843.     TextID(text,id)
  1844.           Normaler Text mit ID
  1845.  
  1846.     TextNR(text)
  1847.           Normaler, rechtsbⁿndiger Text
  1848.  
  1849.     TextRIGHT(text,id)
  1850.           Rechtsbⁿndiger Text mit ID
  1851.  
  1852.     ClippedText(text)
  1853.           Normaler Text, zu langer Text wird abgeschnitten
  1854.  
  1855.     ClippedTextID(text,id)
  1856.           Normaler Text mit ID, zu langer Text wird abgeschnitten
  1857.  
  1858.     CenteredText(text)
  1859.           Zentrierter Text
  1860.  
  1861.     CenteredTextH(text)
  1862.           Zentrierter, hervorgehobener Text
  1863.  
  1864.     CenteredText3(text)
  1865.           Zentrierter Text mit Schatten
  1866.  
  1867.     CenteredTextB(text)
  1868.           Zentrierter, fett geschriebener Text
  1869.  
  1870.     CenteredTextID(text,id)
  1871.           Zentrierter Text mit ID
  1872.  
  1873.     CenteredText_BS(text)
  1874.           Zentrierter Text mit gro▀em Leerraum an Anfang und Ende
  1875.  
  1876.      ---------------------------------------------------------------------
  1877.  
  1878.     Integer(integer)
  1879.           Normale Integerzahl
  1880.  
  1881.     IntegerH(integer)
  1882.           Hervorgehobene Integerzahl
  1883.  
  1884.     Integer3(integer)
  1885.           Integerzahl mit Schatten
  1886.  
  1887.     IntegerB(integer)
  1888.           Fett geschriebene Integerzahl
  1889.  
  1890.     CenteredInteger(integer)
  1891.           Zentrierte Integerzahl
  1892.  
  1893.     CenteredIntegerH(integer)
  1894.           Zentrierte, hervorgehobene Integerzahl
  1895.  
  1896.     CenteredInteger3(integer)
  1897.           Zentrierte Integerzahl mit Schatten
  1898.  
  1899.     CenteredIntegerB(integer)
  1900.           Zentrierte, fett geschriebene Integerzahl
  1901.  
  1902.      ---------------------------------------------------------------------
  1903.  
  1904.     TextBox(text,id,mwid)
  1905.           Ein Text-Anzeigefeld
  1906.  
  1907.     ClippedTextBox(text,id)
  1908.           Wie 'TextBox()', zu langer Text wird abgeschnitten
  1909.  
  1910.     ClippedTextBoxMW(text,id,minwidth)
  1911.           Wie 'ClippedTextBox()', mit Angabe der minimalen Breite
  1912.  
  1913.     IntegerBox(integer,id,minwidth)
  1914.           Ein Anzeigefeld fⁿr Integerzahlen
  1915.  
  1916. DEFINITIONEN
  1917.      -/-
  1918.  
  1919. QuickHelp
  1920. *********
  1921.  
  1922. BESCHREIBUNG
  1923.      Vielen Objekten kann ein kurzer Hilfstext zugeordnet werden, der in
  1924.      einem kleinen Fenster angezeigt wird wenn sich der Mauszeiger ⁿber dem
  1925.      zugeh÷rigen Objekt befindet.
  1926.  
  1927. FUNKTIONEN
  1928.     QuickHelp(helpstring)
  1929.           Dies ist ein Makro, das bei allen Objekten verwendet werden kann
  1930.  
  1931. Fⁿllmuster fⁿr Objekte
  1932. **********************
  1933.  
  1934. BESCHREIBUNG
  1935.      Kennung        Datenangabe             Beschreibung
  1936.      -------------------------------------------------------------------------------
  1937.      TRAT_Backfill  Fⁿllmuster
  1938.      
  1939.                     TRBF_WINDOWBACK         Fenster-Hintergrund
  1940.                     TRBF_REQUESTERBACK      Requester-Hintergrund
  1941.                     TRBF_NONE               Hintergrund
  1942.                     TRBF_SHINE              Farbe der hellen Kanten
  1943.                     TRBF_SHINE_SHADOW       Farben der hellen und dunklen Kanten
  1944.                     TRBF_SHINE_FILL         Farbe der hellen Kanten und Fⁿllfarbe
  1945.                     TRBF_SHINE_BACKGROUND   Farbe der hellen Kanten und Hintergrund
  1946.                     TRBF_SHADOW             Farbe der dunklen Kanten
  1947.                     TRBF_SHADOW_FILL        Farbe der dunklen Kanten und Fⁿllfarbe
  1948.                     TRBF_SHADOW_BACKGROUND  Farbe der dunklen Kanten und Hintergrund
  1949.                     TRBF_FILL               Fⁿllfarbe
  1950.                     TRBF_FILL_BACKGROUND    Fⁿllfarbe und Hintergrund
  1951.  
  1952. DEFINITIONEN
  1953.     ObjectBackfillWin
  1954.           Fenster-Hintergrund
  1955.  
  1956.     ObjectBackfillReq
  1957.           Requester-Hintergrund
  1958.  
  1959.     ObjectBackfillB
  1960.           Screen-Hintergrund
  1961.  
  1962.     ObjectBackfillS
  1963.           Farbe der hellen Kanten
  1964.  
  1965.     ObjectBackfillSA
  1966.           Farben der hellen und dunklen Kanten
  1967.  
  1968.     ObjectBackfillSF
  1969.           Farbe der hellen Kanten und Fⁿllfarbe
  1970.  
  1971.     ObjectBackfillSB
  1972.           Farbe der hellen Kanten und Hintergrundfarbe
  1973.  
  1974.     ObjectBackfillA
  1975.           Farbe der dunklen Kanten
  1976.  
  1977.     ObjectBackfillAF
  1978.           Farbe der dunklen Kanten und Fⁿllfarbe
  1979.  
  1980.     ObjectBackfillAB
  1981.           Farbe der dunklen Kanten und Hintergrundfarbe
  1982.  
  1983.     ObjectBackfillF
  1984.           Fⁿllfarbe
  1985.  
  1986.     ObjectBackfillFB
  1987.           Fⁿllfarbe und Hintergrundfarbe
  1988.  
  1989. Fⁿllmuster fⁿr Fenster
  1990. **********************
  1991.  
  1992. BESCHREIBUNG
  1993.      Kennung        Datenangabe             Beschreibung
  1994.      -------------------------------------------------------------------------------
  1995.      TRWI_Backfill  Fⁿllmuster
  1996.      
  1997.                     TRBF_WINDOWBACK         Fenster-Hintergrund
  1998.                     TRBF_REQUESTERBACK      Requester-Hintergrund
  1999.                     TRBF_NONE               Hintergrund
  2000.                     TRBF_SHINE              Farbe der hellen Kanten
  2001.                     TRBF_SHINE_SHADOW       Farben der hellen und dunklen Kanten
  2002.                     TRBF_SHINE_FILL         Farbe der hellen Kanten und Fⁿllfarbe
  2003.                     TRBF_SHINE_BACKGROUND   Farbe der hellen Kanten und Hintergrund
  2004.                     TRBF_SHADOW             Farbe der dunklen Kanten
  2005.                     TRBF_SHADOW_FILL        Farbe der dunklen Kanten und Fⁿllfarbe
  2006.                     TRBF_SHADOW_BACKGROUND  Farbe der dunklen Kanten und Hintergrund
  2007.                     TRBF_FILL               Fⁿllfarbe
  2008.                     TRBF_FILL_BACKGROUND    Fⁿllfarbe und Hintergrund
  2009.  
  2010. DEFINITIONEN
  2011.     WindowBackfillWin
  2012.           Fenster-Hintergrund
  2013.  
  2014.     WindowBackfillReq
  2015.           Requester-Hintergrund
  2016.  
  2017.     WindowBackfillNone
  2018.           Screen-Hintergrund
  2019.  
  2020.     WindowBackfillS
  2021.           Farbe der hellen Kanten
  2022.  
  2023.     WindowBackfillSA
  2024.           Farben der hellen und dunklen Kanten
  2025.  
  2026.     WindowBackfillSF
  2027.           Farbe der hellen Kanten und Fⁿllfarbe
  2028.  
  2029.     WindowBackfillSB
  2030.           Farbe der hellen Kanten und Hintergrundfarbe
  2031.  
  2032.     WindowBackfillA
  2033.           Farbe der dunklen Kanten
  2034.  
  2035.     WindowBackfillAF
  2036.           Farbe der dunklen Kanten und Fⁿllfarbe
  2037.  
  2038.     WindowBackfillAB
  2039.           Farbe der dunklen Kanten und Hintergrundfarbe
  2040.  
  2041.     WindowBackfillF
  2042.           Fⁿllfarbe
  2043.  
  2044.     WindowBackfillFB
  2045.           Fⁿllfarbe und Hintergrundfarbe
  2046.  
  2047. Funktionen der Library
  2048. **********************
  2049.  
  2050. Alle Funktionen k÷nnen auch ⁿber ein Alias aufgerufen werden, indem man dem
  2051. Funktionsnamen ein 'TRX_' voranstellt. Siehe Tips und Probleml÷sungen.
  2052.  
  2053. Triton-Funktionen
  2054.  
  2055. * TR_CreateApp()          - Applikation erzeugen
  2056. * TR_DeleteApp()          - Applikation l÷schen
  2057.  
  2058. * TR_OpenProject()        - Projekt/Fenster ÷ffnen
  2059. * TR_CloseProject()       - Projekt/Fenster schlie▀en
  2060. * TR_LockProject()        - Projekt/Fenster fⁿr Eingaben sperren
  2061. * TR_UnlockProject()      - Projekt/Fenster fⁿr Eingaben freigeben
  2062. * TR_LockScreen()         - Bildschirm eines Projekts ⁿbernehmen
  2063. * TR_UnlockScreen()       - Bildschirm eines Projekts freigeben
  2064. * TR_ObtainWindow()       - Fenster eines Projekts ⁿbernehmen
  2065. * TR_ReleaseWindow()      - Fenster eines Projekts freigeben
  2066.  
  2067. * TR_AutoRequest()        - Fenster als Requester ÷ffnen
  2068. * TR_EasyRequest()        - Einfachen Requester ÷ffnen
  2069.  
  2070. * TR_GetAttribute()       - Attribut eines Objekts abfragen
  2071. * TR_SetAttribute()       - Attribut eines Objekts Σndern
  2072. * TR_SendMessage()        - Nachricht an ein Objekt schicken
  2073.  
  2074. * TR_Wait()               - Auf Nachrichten einer Applikation warten
  2075. * TR_GetMsg()             - Nachricht von einer Applikation empfangen
  2076. * TR_ReplyMsg()           - Nachricht einer Applikation beantworten
  2077. * TR_HandleMsg()          - Nachricht empfangen und beantworten
  2078.  
  2079. * TR_FirstOccurance()     - Zeichen in einem Text suchen
  2080. * TR_NumOccurances()      - Zeichen in einem Text zΣhlen
  2081.  
  2082. * TR_GetLastError()       - Zuletzt aufgetretenen Fehler ermitteln
  2083. * TR_GetErrorString()     - Fehlerbeschreibung anfordern
  2084.  
  2085. Datei- und Fontrequester
  2086.  
  2087. * ASL_RequestFile()       - Datei-Requester aufrufen
  2088. * ASL_RequestFont()       - Font-Requester aufrufen
  2089.  
  2090. Grafiken
  2091.  
  2092. * CreateImage()           - Grafik von Disk laden
  2093. * DeleteImage()           - Grafik aus dem Speicher l÷schen
  2094.  
  2095. Sonstiges
  2096.  
  2097. * ActivateProject()       - Fenster eines Projekts aktivieren
  2098. * ProjectToFront()        - Fenster eines Projekts nach vorne
  2099. * ProjectToBack()         - Fenster eines Projekts nach hinten
  2100.  
  2101. * TritonRexxVersion()     - Version der 'tritonrexx.library' ermitteln
  2102. * TritonVersion()         - Version der 'triton.library' ermitteln
  2103.  
  2104. Die Funktion TR_CreateApp() - Applikation erzeugen
  2105. **************************************************
  2106.  
  2107. NAME
  2108.      app = TR_CreateApp(taglist)
  2109.  
  2110. BESCHREIBUNG
  2111.      Erzeugt eine Applikation. Eine Applikation ist die Grundlage fⁿr alle
  2112.      Fenster, daher mu▀ diese Funktion immer aufgerufen werden bevor Fenster
  2113.      ge÷ffnet werden k÷nnen.
  2114.  
  2115. ARGUMENTE
  2116.      taglist - Eine Tagliste, die die Beschreibung der Applikation enthΣlt.
  2117.                Siehe Applikationen.
  2118.  
  2119. ERGEBNIS
  2120.      app     - Eine Kennzahl fⁿr die erzeugte Applikation im binΣren Format.
  2121.                '00000000'x wenn die Applikation nicht erzeugt werden konnte.
  2122.  
  2123. SIEHE AUCH
  2124.      TR_DeleteApp()
  2125.  
  2126. Die Funktion TR_DeleteApp() - Applikation l÷schen
  2127. *************************************************
  2128.  
  2129. NAME
  2130.      dummy = TR_DeleteApp(app)
  2131.  
  2132. BESCHREIBUNG
  2133.      L÷scht eine zuvor mit 'TR_CreateApp()' erzeugte Applikation. Alle zu
  2134.      dieser Applikation geh÷renden Projekte/Fenster werden ebenfalls
  2135.      geschlossen!
  2136.  
  2137. ARGUMENTE
  2138.      app   - Die Kennzahl der Applikation, die gel÷scht werden soll
  2139.              Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
  2140.  
  2141. ERGEBNIS
  2142.      dummy - immer 1
  2143.  
  2144. SIEHE AUCH
  2145.      TR_CreateApp()
  2146.  
  2147. Die Funktion TR_OpenProject() - Projekt/Fenster ÷ffnen
  2148. ******************************************************
  2149.  
  2150. NAME
  2151.      project = TR_OpenProject(app,taglist)
  2152.  
  2153. BESCHREIBUNG
  2154.      ╓ffnet ein Projekt/Fenster
  2155.  
  2156. ARGUMENTE
  2157.      app     - Die Kennzahl der Applikation, zu der das Fenster geh÷rt.
  2158.                Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
  2159.      
  2160.      taglist - Tagliste, die die Beschreibung des Projekts enthΣlt. Die
  2161.                Eigenschaften mⁿssen in der Tagliste in einer bestimmten
  2162.                Reihenfolge angegeben werden:
  2163.      
  2164.                1. Fensterbeschreibung    Siehe Projekte-Fenster.
  2165.                2. Menⁿbeschreibungen     Siehe Menⁿs.
  2166.                3. Objektbeschreibungen   Siehe Objekte und Attribute.
  2167.  
  2168. ERGEBNIS
  2169.      project - Eine Kennzahl fⁿr das ge÷ffnete Projekt im binΣren Format.
  2170.                '00000000'x wenn das Projekt nicht ge÷ffnet werden konnte.
  2171.  
  2172. SIEHE AUCH
  2173.      TR_CreateApp() TR_CloseProject()
  2174.  
  2175. Die Funktion TR_CloseProject() - Projekt/Fenster schlie▀en
  2176. **********************************************************
  2177.  
  2178. NAME
  2179.      dummy = TR_CloseProject(project)
  2180.  
  2181. BESCHREIBUNG
  2182.      Schlie▀t ein zuvor mit 'TR_OpenProject()' ge÷ffnetes Projekt.
  2183.  
  2184. ARGUMENTE
  2185.      project - Die Kennzahl des Projekts, das gel÷scht werden soll.
  2186.                Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2187.  
  2188. ERGEBNIS
  2189.      dummy   - immer 1
  2190.  
  2191. SIEHE AUCH
  2192.      TR_OpenProject()
  2193.  
  2194. Die Funktion TR_LockProject() - Projekt/Fenster fⁿr Eingaben sperren
  2195. ********************************************************************
  2196.  
  2197. NAME
  2198.      dummy = TR_LockProject(project)
  2199.  
  2200. BESCHREIBUNG
  2201.      Sperrt ein Projekt. Im Fenster des gesperrten Projekts sind keinerlei
  2202.      Eingaben mehr m÷glich. Das Verkleinern und Vergr÷▀ern des Fensters
  2203.      ist jedoch weiterhin m÷glich.
  2204.  
  2205. ARGUMENTE
  2206.      project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
  2207.                soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2208.  
  2209. ERGEBNIS
  2210.      dummy   - immer 1
  2211.  
  2212. SIEHE AUCH
  2213.      TR_OpenProject() TR_UnlockProject()
  2214.  
  2215. Die Funktion TR_UnlockProject() - Projekt/Fenster fⁿr Eingaben freigeben
  2216. ************************************************************************
  2217.  
  2218. NAME
  2219.      dummy = TR_UnlockProject(project)
  2220.  
  2221. BESCHREIBUNG
  2222.      Gibt ein zuvor gesperrtes Projekt wieder fⁿr Eingaben frei.
  2223.  
  2224. ARGUMENTE
  2225.      project - Die Kennzahl des Projekts, das freigegeben werden soll.
  2226.                Dies ist der gleiche Wert, der zuvor bei 'TR_LockProject()'
  2227.                angegeben wurde.
  2228.  
  2229. ERGEBNIS
  2230.      dummy   - immer 1
  2231.  
  2232. SIEHE AUCH
  2233.      TR_LockProject()
  2234.  
  2235. Die Funktion TR_LockScreen() - Bildschirm eines Projekts ⁿbernehmen
  2236. *******************************************************************
  2237.  
  2238. NAME
  2239.      screen = TR_LockScreen(project)
  2240.  
  2241. BESCHREIBUNG
  2242.      Liefert einen Zeiger auf den Bildschirm des angegebenen Projekts, und
  2243.      verhindert, da▀ der Bildschirm geschlossen werden kann. Der Bildschirm
  2244.      kann jetzt gefahrlos zum ╓ffnen von anderen Fenstern verwendet werden.
  2245.  
  2246. ARGUMENTE
  2247.      project - Die Kennzahl des Projekts, dessen Bildschirm ⁿbernommen werden
  2248.                soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2249.  
  2250. ERGEBNIS
  2251.      screen  - Zeiger auf die Screen-Struktur des Bildschirms im binΣren
  2252.                Format, '00000000'x im Fehlerfall.
  2253.  
  2254. SIEHE AUCH
  2255.      TR_OpenProject() TR_UnlockScreen()
  2256.  
  2257. Die Funktion TR_UnlockScreen() - Bildschirm eines Projekts freigeben
  2258. ********************************************************************
  2259.  
  2260. NAME
  2261.      dummy = TR_UnlockScreen(screen)
  2262.  
  2263. BESCHREIBUNG
  2264.      Gibt einen zuvor mit 'TR_LockScreen()' ⁿbernommenen Bildschirm frei. Der
  2265.      Bildschirm kann erst nach dem Aufruf dieser Funktion wieder geschlossen
  2266.      werden.
  2267.  
  2268. ARGUMENTE
  2269.      screen - Zeiger auf die Screen-Struktur des Bildschirms, der freigegeben
  2270.               werden soll. Dies ist der Rⁿckgabewert von 'TR_LockScreen()'.
  2271.  
  2272. ERGEBNIS
  2273.      dummy  - immer 1
  2274.  
  2275. SIEHE AUCH
  2276.      TR_LockScreen()
  2277.  
  2278. Die Funktion TR_ObtainWindow() - Fenster eines Projekts ⁿbernehmen
  2279. ******************************************************************
  2280.  
  2281. NAME
  2282.      window = TR_ObtainWindow(project)
  2283.  
  2284. BESCHREIBUNG
  2285.      Liefert einen Zeiger auf das Fenster des angegebenen Projekts, und
  2286.      erlaubt es das Fenster mit 'Nicht-Triton-Funktionen' zu manipulieren.
  2287.      Man kann z.B. das Fenster nach vorne oder hinten legen, aktivieren oder
  2288.      deaktivieren. Der Inhalt des Fensters darf auf keinen Fall verΣndert
  2289.      werden! Das Fenster mu▀ spΣter mit 'TR_ReleaseWindow()' wieder
  2290.      freigegeben werden.
  2291.  
  2292. ARGUMENTE
  2293.      project - Die Kennzahl des Projekts, dessen Fenster ⁿbernommen werden
  2294.                soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2295.  
  2296. ERGEBNIS
  2297.      window  - Zeiger auf die Window-Struktur des Fensters im binΣren
  2298.                Format, '00000000'x im Fehlerfall.
  2299.  
  2300. SIEHE AUCH
  2301.      TR_OpenProject() TR_ReleaseWindow() ProjectToFront() ProjectToBack()
  2302.  
  2303. Die Funktion TR_ReleaseWindow() - Fenster eines Projekts freigeben
  2304. ******************************************************************
  2305.  
  2306. NAME
  2307.      dummy = TR_ReleaseWindow(window)
  2308.  
  2309. BESCHREIBUNG
  2310.      Gibt ein zuvor mit 'TR_ObtainWindow()' ⁿbernommenes Fenster frei.
  2311.  
  2312. ARGUMENTE
  2313.      window - Zeiger auf die Window-Struktur des Fensters, das freigegeben
  2314.               werden soll. Dies ist der Rⁿckgabewert von 'TR_ObtainWindow()'.
  2315.  
  2316. ERGEBNIS
  2317.      dummy  - immer 1
  2318.  
  2319. SIEHE AUCH
  2320.      TR_ObtainWindow()
  2321.  
  2322. Die Funktion ActivateProject() - Fenster eines Projekts aktivieren
  2323. ******************************************************************
  2324.  
  2325. NAME
  2326.      dummy = ActivateProject(project)
  2327.  
  2328. BESCHREIBUNG
  2329.      Aktiviert das zum angegebenen Projekt geh÷rende Fenster.
  2330.  
  2331. ARGUMENTE
  2332.      project - Die Kennzahl des Projekts, dessen Fenster aktiviert werden
  2333.                soll, Rⁿckgabewert von 'TR_OpenProject()'.
  2334.  
  2335. ERGEBNIS
  2336.      dummy   - immer 1
  2337.  
  2338. SIEHE AUCH
  2339.      ProjectToBack() ProjectToFront() TR_ObtainWindow() TR_ReleaseWindow()
  2340.  
  2341. Die Funktion ProjectToFront() - Fenster eines Projekts nach vorne
  2342. *****************************************************************
  2343.  
  2344. NAME
  2345.      dummy = ProjectToFront(project)
  2346.  
  2347. BESCHREIBUNG
  2348.      Bringt das zum angegebenen Projekt geh÷rende Fenster in den Vordergrund.
  2349.  
  2350. ARGUMENTE
  2351.      project - Die Kennzahl des Projekts, dessen Fenster in den Vordergrund
  2352.                gebracht werden soll, Rⁿckgabewert von 'TR_OpenProject()'.
  2353.  
  2354. ERGEBNIS
  2355.      dummy   - immer 1
  2356.  
  2357. SIEHE AUCH
  2358.      ActivateProject() ProjectToBack() TR_ObtainWindow() TR_ReleaseWindow()
  2359.  
  2360. Die Funktion ProjectToBack() - Fenster eines Projekts nach hinten
  2361. *****************************************************************
  2362.  
  2363. NAME
  2364.      dummy = ProjectToBack(project)
  2365.  
  2366. BESCHREIBUNG
  2367.      Bringt das zum angegebenen Projekt geh÷rende Fenster in den Hintergrund.
  2368.  
  2369. ARGUMENTE
  2370.      project - Die Kennzahl des Projekts, dessen Fenster in den Hintergrund
  2371.                gebracht werden soll, Rⁿckgabewert von 'TR_OpenProject()'.
  2372.  
  2373. ERGEBNIS
  2374.      dummy   - immer 1
  2375.  
  2376. SIEHE AUCH
  2377.      ActivateProject() ProjectToFront() TR_ObtainWindow() TR_ReleaseWindow()
  2378.  
  2379. Die Funktion TR_AutoRequest() - Fenster als Requester ÷ffnen
  2380. ************************************************************
  2381.  
  2382. NAME
  2383.      auswahl = TR_AutoRequest(app,project,taglist)
  2384.  
  2385. BESCHREIBUNG
  2386.      ╓ffnet einen durch die Tagliste beschriebenen Requester. Sobald eine
  2387.      Nachricht vom Typ 'TRMS_ACTION' eintrifft wird der Requester sofort
  2388.      wieder geschlossen. Wenn ein Projekt angegeben ist, wird dieses in der
  2389.      Zeit, in der der Requester ge÷ffnet ist, fⁿr Eingaben gesperrt.
  2390.  
  2391. ARGUMENTE
  2392.      app     - Die Kennzahl der Applikation, zu der der Requester geh÷rt.
  2393.                Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
  2394.      
  2395.      project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
  2396.                soll. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2397.                '00000000'x wenn kein Projekt gesperrt werden soll.
  2398.      
  2399.      taglist - Tagliste, die die Beschreibung des Requesters enthΣlt.
  2400.                Siehe TR_OpenProject().
  2401.  
  2402. ERGEBNIS
  2403.      auswahl - Die ID-Nummer des Objekts, das die 'TRMS_ACTION'-Nachricht
  2404.                ausgel÷st hat. -1 wenn das Schlie▀symbol des Fensters
  2405.                angeklickt wurde.
  2406.  
  2407. SIEHE AUCH
  2408.      TR_EasyRequest()
  2409.  
  2410. Die Funktion TR_EasyRequest() - Einfachen Requester ÷ffnen
  2411. **********************************************************
  2412.  
  2413. NAME
  2414.      auswahl = TR_EasyRequest(app,text,gadgets,taglist)
  2415.  
  2416. BESCHREIBUNG
  2417.      ╓ffnet einen einfachen Requester.
  2418.  
  2419. ARGUMENTE
  2420.      app     - Die Kennzahl der Applikation, zu der der Requester geh÷rt.
  2421.                Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
  2422.      
  2423.      text    - Text, der im Requester dargestellt werden soll.
  2424.      
  2425.      gadgets - Die Texte in den Gadgets des Requesters, getrennt durch '|'.
  2426.      
  2427.      taglist - Eine Tagliste, die die Eigenschaften des Requesters enthΣlt.
  2428.      
  2429.                Kennung           Datenangabe   Beschreibung
  2430.                -----------------------------------------------------------------
  2431.                TREZ_ReqPos       Position      Die Position des Requesters auf
  2432.                                                dem Bildschirm, hier gilt das
  2433.                                                gleiche wie beim ╓ffnen eines
  2434.                                                Projekts/Fensters. Standard ist
  2435.                                                'TRWP_MOUSEPOINTER'.
  2436.                                                Siehe Projekte-Fenster.
  2437.      
  2438.                TREZ_LockProject  Projekt       Die von 'TR_OpenProject()'
  2439.                                                erhaltene Kennzahl eines Projekts,
  2440.                                                das solange der Requester ge÷ffnet
  2441.                                                ist fⁿr Eingaben gesperrt werden
  2442.                                                soll. Der Requester wird auf dem
  2443.                                                Bildschirm des hier angegebenen
  2444.                                                Projekts ge÷ffnet.
  2445.      
  2446.                                                Achtung:
  2447.                                                ---------------------------------
  2448.                                                Die Projekt-Kennzahl liegt im
  2449.                                                binΣren Format vor! Sie kann hier
  2450.                                                nicht einfach angegeben werden,
  2451.                                                sondern mu▀ vorher in eine Zahl
  2452.                                                umgewandelt werden! Dazu wird die
  2453.                                                ARexx-Funktion 'C2D()' verwendet!
  2454.      
  2455.                TREZ_Return       Integer       Die Nummer des Gadgets, das mit
  2456.                                                RETURN angewΣhlt werden kann.
  2457.                                                Standard ist 1, bei Requestern mit
  2458.                                                nur einem Gadget 0.
  2459.      
  2460.                TREZ_Title        Zeichenkette  Der Fenstertitel des Requesters.
  2461.                                                Standard ist 'System-Request'.
  2462.      
  2463.                TREZ_Activate     Bool          Gibt an ob der Requester aktiviert
  2464.                                                ist. Wenn dies nicht angegeben ist
  2465.                                                wird der Zustand des Requesters
  2466.                                                von dem bei 'TREZ_LockProject'
  2467.                                                angegebenen Projekt ⁿbernommen.
  2468.  
  2469. ERGEBNIS
  2470.      auswahl - Die Nummer des angewΣhlten Gadgets, -1 wenn ein Fehler
  2471.                aufgetreten ist. Die Gadgets werden von links nach rechts
  2472.                durchnummeriert, beginnend bei 1. Das ganz rechte Gadget
  2473.                hat die Nummer 0.
  2474.  
  2475. SIEHE AUCH
  2476.      TR_AutoRequest()
  2477.  
  2478. Die Funktion TR_GetAttribute() - Attribut eines Objekts abfragen
  2479. ****************************************************************
  2480.  
  2481. NAME
  2482.      value = TR_GetAttribute(project,id,attribute)
  2483.  
  2484. BESCHREIBUNG
  2485.      Eigenschaft eines Objekts oder Projekts abfragen. Eigenschaften von
  2486.      Objekten k÷nnen nur abgefragt werden wenn das Objekt eine ID-Nummer
  2487.      besitzt.
  2488.  
  2489. ARGUMENTE
  2490.      project   - Die Kennzahl des Projekts, welches das abzufragende Objekt
  2491.                  enthΣlt. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2492.      
  2493.      id        - ID-Nummer des Objekts, das abgefragt werden soll. Wenn eine
  2494.                  Eigenschaft des Projekts abgefragt werden soll mu▀ hier 0
  2495.                  angegeben werden.
  2496.      
  2497.      attribute - Die Kennung der Eigenschaft, die abgefragt werden soll. Wenn
  2498.                  die Standard-Eigenschaft eines Objekts abgefragt werden soll
  2499.                  mu▀ hier die Kennung des Objekts selbst angegeben werden!
  2500.                  z.B. 'TROB_String', wenn der in einem Eingabefeld enthaltene
  2501.                  Text abgefragt werden soll.
  2502.  
  2503. ERGEBNIS
  2504.      value     - Der abgefragte Wert. Dieser Wert hat je nach Objekt und
  2505.                  Eigenschaft ein ganz bestimmtes Format. Es gilt immer das,
  2506.                  was auch beim ╓ffnen eines Projekts angegeben wird.
  2507.      
  2508.                  Siehe Taglisten verwenden.
  2509.                  Siehe Projekte-Fenster.
  2510.                  Siehe Menⁿs.
  2511.                  Siehe Objekte und Attribute.
  2512.  
  2513. SIEHE AUCH
  2514.      TR_SetAttribute()
  2515.  
  2516. Die Funktion TR_SetAttribute() - Attribut eines Objekts Σndern
  2517. **************************************************************
  2518.  
  2519. NAME
  2520.      dummy = TR_SetAttribute(project,id,attribute,value)
  2521.  
  2522. BESCHREIBUNG
  2523.      Eigenschaft eines Objekts oder Projekts Σndern. Eigenschaften von
  2524.      Objekten k÷nnen nur geΣndert werden wenn das Objekt eine ID-Nummer
  2525.      besitzt.
  2526.  
  2527. ARGUMENTE
  2528.      project   - Die Kennzahl des Projekts, welches das zu Σndernde Objekt
  2529.                  enthΣlt. Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2530.      
  2531.      id        - ID-Nummer des Objekts, das geΣndert werden soll. Wenn eine
  2532.                  Eigenschaft des Projekts geΣndert werden soll mu▀ hier 0
  2533.                  angegeben werden.
  2534.      
  2535.      attribute - Die Kennung der Eigenschaft, die geΣndert werden soll. Wenn
  2536.                  die Standard-Eigenschaft eines Objekts geΣndert werden soll
  2537.                  mu▀ hier die Kennung des Objekts selbst angegeben werden!
  2538.                  z.B. 'TROB_String', wenn ein neuer Text in einem Eingabefeld
  2539.                  angezeigt werden soll.
  2540.      
  2541.      value     - Der Wert, der neu eingestellt werden soll. Dieser Wert mu▀
  2542.                  je nach Objekt und Eigenschaft ein ganz bestimmtes Format
  2543.                  haben. Es gilt immer das, was auch beim ╓ffnen eines Projekts
  2544.                  angegeben wird.
  2545.      
  2546.                  Siehe Taglisten verwenden.
  2547.                  Siehe Projekte-Fenster.
  2548.                  Siehe Menⁿs.
  2549.                  Siehe Objekte und Attribute.
  2550.  
  2551. ERGEBNIS
  2552.      dummy     - immer 1
  2553.  
  2554. SIEHE AUCH
  2555.      TR_GetAttribute()
  2556.  
  2557. Die Funktion TR_SendMessage() - Nachricht an ein Objekt schicken
  2558. ****************************************************************
  2559.  
  2560. NAME
  2561.      dummy = TR_SendMessage(project,id,message,data)
  2562.  
  2563. BESCHREIBUNG
  2564.      Sendet eine Nachricht an ein Objekt oder Projekt.
  2565.  
  2566. ARGUMENTE
  2567.      project   - Die Kennzahl des Projekts, welches das Objekt enthΣlt.
  2568.                  Dies ist der Rⁿckgabewert von 'TR_OpenProject()'.
  2569.      
  2570.      id        - ID-Nummer des Objekts, an das die Nachricht geschickt
  2571.                  werden soll. Soll die Nachricht an das Projekt geschickt
  2572.                  werden, dann mu▀ hier 0 angegeben werden.
  2573.      
  2574.      message   - Die Kennung der Nachricht, die verschickt werden soll.
  2575.      
  2576.      data      - Die Daten, die mit der Nachricht ⁿbermittelt werden sollen.
  2577.      
  2578.                  message           data              Beschreibung
  2579.                  -------------------------------------------------------------
  2580.                  TROM_ACTIVATE     Ungenutzt         Aktiviert ein Objekt
  2581.      
  2582.                  z.B.: Aktivieren eines Texteingabefeldes mit der ID 7
  2583.      
  2584.                  CALL TR_SendMessage(project,7,'TROM_ACTIVATE',0)
  2585.  
  2586. ERGEBNIS
  2587.      dummy     - immer 1
  2588.  
  2589. SIEHE AUCH
  2590.      -/-
  2591.  
  2592. Die Funktion TR_GetMsg() - Nachricht von einer Applikation empfangen
  2593. ********************************************************************
  2594.  
  2595. NAME
  2596.      message = TR_GetMsg(app,stemvar)
  2597.  
  2598. BESCHREIBUNG
  2599.      EmpfΣngt eine Nachricht von eine Applikation. Jede erhaltene Nachricht
  2600.      mu▀ unbedingt mit der Funktion 'TR_ReplyMsg()' beantwortet werden!
  2601.  
  2602. ARGUMENTE
  2603.      app     - Die Kennzahl der Applikation, von der eine Nachricht empfangen
  2604.                werden soll. Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
  2605.      
  2606.      stemvar - Eine Stem-Variable, in der die Daten der Nachricht gespeichert
  2607.                werden sollen. Die Daten werden wie folgt gespeichert:
  2608.      
  2609.                stemvar.trm_project
  2610.                     Die Kennzahl des zur Nachricht geh÷renden Projekts im
  2611.                     binΣren Format
  2612.      
  2613.                stemvar.trm_id
  2614.                     Die ID-Nummer des Objekts, das die Nachricht ausgel÷st hat
  2615.      
  2616.                stemvar.trm_class
  2617.                     Die Art der Nachricht:
  2618.      
  2619.                     TRMS_CLOSEWINDOW  - Das Fenster soll geschlossen werden,
  2620.                                         Schlie▀symbol wurde angeklickt oder
  2621.                                         ESC wurde gedrⁿckt.
  2622.      
  2623.                     TRMS_ERROR        - Ein Fehler ist aufgetreten, der
  2624.                                         Fehlercode steht in 'stemvar.trm_data'.
  2625.      
  2626.                     TRMS_NEWVALUE     - Daten eines Objekt wurden verΣndert, der
  2627.                                         neue Wert steht in 'stemvar.trm_data'.
  2628.                                         z.B. Neuer Text im Eingabefeld oder der
  2629.                                         gerade ausgewΣhlte Eintrag in einem
  2630.                                         Listview-Objekt.
  2631.      
  2632.                     TRMS_ACTION       - Objekt l÷st eine Aktion aus, z.B. wenn
  2633.                                         ein Knopf angewΣhlt wurde.
  2634.      
  2635.                     TRMS_ICONDROPPED  - Ein oder mehrere Icons wurden auf dem
  2636.                                         Fenster, dann ist 'stemvar.trm_id' = 0,
  2637.                                         oder einem 'DropBox'-Objekt, dann ist
  2638.                                         'stemvar.trm_id' die ID-Nummer, fallen
  2639.                                         gelassen. Die Pfadnamen der Icons stehen
  2640.                                         in 'stemvar.trm_data':
  2641.      
  2642.                                         stemvar.trm_data.0 - Anzahl der Icons
  2643.                                         stemvar.trm_data.1 - erster Pfadname
  2644.                                         stemvar.trm_data.2 - zweiter Pfadname
  2645.                                         stemvar.trm_data.3 - dritter Pfadname
  2646.                                         stemvar.trm_data.n - n'ter Pfadname
  2647.      
  2648.                     TRMS_KEYPRESSED   - Eine Taste wurde gedrⁿckt, die Tastencodes
  2649.                                         werden wie folgt gespeichert:
  2650.      
  2651.                                         stemvar.trm_data      - ASCII-Code
  2652.                                         stemvar.trm_code      - Tastatur-Code
  2653.                                         stemvar.trm_qualifier - Qualifier-Code
  2654.      
  2655.                     TRMS_HELP         - Der User fordert Hilfe fⁿr das Objekt
  2656.                                         mit der in 'stemvar.trm_id' gespeicherten
  2657.                                         ID-Nummer an.
  2658.      
  2659.                     TRMS_DISKINSERTED - Eine Diskette wurde eingelegt.
  2660.      
  2661.                     TRMS_DISKREMOVED  - Eine Diskette wurde entnommen.
  2662.      
  2663.                stemvar.trm_data
  2664.                     Daten, je nach Art der Nachricht
  2665.      
  2666.                stemvar.trm_code
  2667.                     Tastaturcode bei 'TRMS_KEYPRESSED'
  2668.      
  2669.                stemvar.trm_qualifier
  2670.                     Qualifiercode
  2671.      
  2672.                stemvar.trm_seconds
  2673.                     Aktuelle Systemzeit in Sekunden seit dem 01.01.1978
  2674.      
  2675.                stemvar.trm_micros
  2676.                     Microsekunden-Wert der Systemzeit
  2677.      
  2678.                stemvar.trm_app
  2679.                     Die Kennzahl der zur Nachricht geh÷renden Applikation im
  2680.                     binΣren Format.
  2681.  
  2682. ERGEBNIS
  2683.      message - Eine Kennzahl fⁿr die empfangene Nachricht im binΣren Format.
  2684.               Diese Kennzahl mu▀ beim Beantworten der Nachricht mittels
  2685.           'TR_ReplyMsg()' wieder angegeben werden! Alle Nachrichten
  2686.      mⁿssen so schnell wie m÷glich beantwortet werden, um eine
  2687.      reibungslose Funktion zu gewΣhrleisten!
  2688.  
  2689. SIEHE AUCH
  2690.      TR_Wait() TR_ReplyMsg() TR_HandleMsg()
  2691.  
  2692. Die Funktion TR_ReplyMsg() - Nachricht einer Applikation beantworten
  2693. ********************************************************************
  2694.  
  2695. NAME
  2696.      dummy = TR_ReplyMsg(message)
  2697.  
  2698. BESCHREIBUNG
  2699.      Beantwortet eine Nachricht, die mit 'TR_GetMsg()' empfangen wurde.
  2700.  
  2701. ARGUMENTE
  2702.      message - Die Kennzahl der Nachricht, die beantwortet werden soll.
  2703.                Dies ist der Rⁿckgabewert von 'TR_GetMsg()'.
  2704.  
  2705. ERGEBNIS
  2706.      dummy   - immer 1
  2707.  
  2708. SIEHE AUCH
  2709.      TR_Wait() TR_GetMsg() TR_HandleMsg()
  2710.  
  2711. Die Funktion TR_Wait() - Nachricht einer Applikation beantworten
  2712. ****************************************************************
  2713.  
  2714. NAME
  2715.      signale = TR_Wait(app,signale)
  2716.  
  2717. BESCHREIBUNG
  2718.      Wartet bis die angegebene Applikation eine Nachricht bereitstellt, oder
  2719.      auf das Auftreten von einem der angegebenen Unterbrechungs-Signale.
  2720.  
  2721. ARGUMENTE
  2722.      app     - Die Kennzahl der Applikation, auf die gewartet werden soll.
  2723.      
  2724.      signale - Hier k÷nnen Signale angegeben werden, auf die zusΣtzlich
  2725.                gewartet werden soll. Es wird ein Text angegeben, der die
  2726.                folgenden Buchstaben enthalten kann:
  2727.      
  2728.                C - es wird zusΣtzlich auf CTRL-C gewartet
  2729.                D - es wird zusΣtzlich auf CTRL-D gewartet
  2730.                E - es wird zusΣtzlich auf CTRL-E gewartet
  2731.                F - es wird zusΣtzlich auf CTRL-F gewartet
  2732.      
  2733.                z.B. 'CF' - wartet auf CTRL-C und CTRL-F
  2734.                     ''   - wartet auf keine zusΣtzlichen Signale
  2735.  
  2736. ERGEBNIS
  2737.      signale - Die aufgetretenen Signale im oben beschriebenen Format.
  2738.  
  2739. SIEHE AUCH
  2740.      TR_GetMsg() TR_ReplyMsg() TR_HandleMsg()
  2741.  
  2742. Die Funktion TR_HandleMsg() - Nachricht einer Applikation empfangen und beantworten
  2743. ***********************************************************************************
  2744.  
  2745. NAME
  2746.      bool = TR_HandleMsg(app,stemvar)
  2747.  
  2748. BESCHREIBUNG
  2749.      Erfⁿllt den gleichen Zweck wie die Funktionen 'TR_GetMsg()' und
  2750.      'TR_ReplyMsg()' zusammen, die empfangene Nachricht wird automatisch
  2751.      beantwortet!
  2752.  
  2753. ARGUMENTE
  2754.      app     - Die Kennzahl der Applikation, von der eine Nachricht empfangen
  2755.                werden soll. Dies ist der Rⁿckgabewert von 'TR_CreateApp()'.
  2756.      
  2757.      stemvar - Stem-Variable, in der die Daten der Nachricht gespeichert
  2758.                werden sollen. Siehe TR_GetMsg().
  2759.  
  2760. ERGEBNIS
  2761.      bool    - 1 wenn eine korrekte Nachricht empfangen wurde, 0 wenn nicht
  2762.  
  2763. SIEHE AUCH
  2764.      TR_Wait() TR_GetMsg() TR_ReplyMsg()
  2765.  
  2766. Die Funktion TR_FirstOccurance() - Zeichen in einem Text suchen
  2767. ***************************************************************
  2768.  
  2769. NAME
  2770.      position = TR_FirstOccurance(char,string)
  2771.  
  2772. BESCHREIBUNG
  2773.      Sucht in einer Zeichenkette nach dem ersten Auftreten eines Zeichens.
  2774.  
  2775. ARGUMENTE
  2776.      char     - Das Zeichen, nach dem gesucht werden soll.
  2777.      
  2778.      string   - Die Zeichenkette, die durchsucht werden soll.
  2779.  
  2780. ERGEBNIS
  2781.      position - Die Position, an der das Zeichen zum ersten Mal auftritt.
  2782.                 Das erste Zeichen hat die Nummer 1. 0 bedeutet, da▀ das
  2783.                 Zeichen nicht in der Zeichenkette vorkommt.
  2784.  
  2785. SIEHE AUCH
  2786.      TR_NumOccurances()
  2787.  
  2788. Die Funktion TR_NumOccurances() - Zeichen in einem Text zΣhlen
  2789. **************************************************************
  2790.  
  2791. NAME
  2792.      count = TR_NumOccurances(char,string)
  2793.  
  2794. BESCHREIBUNG
  2795.      ZΣhlt, wie oft ein Zeichen in einer Zeichenkette enthalten ist.
  2796.  
  2797. ARGUMENTE
  2798.      char   - Das Zeichen, das gezΣhlt werden soll.
  2799.      
  2800.      string - Die Zeichenkette, die durchsucht werden soll.
  2801.  
  2802. ERGEBNIS
  2803.      count  - Die Anzahl, wie oft das zeichen in der Zeichenkette
  2804.               enthalten ist.
  2805.  
  2806. SIEHE AUCH
  2807.      TR_FirstOccurance()
  2808.  
  2809. Die Funktion TR_GetLastError() - Zuletzt aufgetretenen Fehler ermitteln
  2810. ***********************************************************************
  2811.  
  2812. NAME
  2813.      error = TR_GetLastError(app)
  2814.  
  2815. BESCHREIBUNG
  2816.      Ermittelt die Nummer des bei einer Applikation zuletzt aufgetretenen
  2817.      Fehlers.
  2818.  
  2819. ARGUMENTE
  2820.      app   - Die Kennzahl der Applikation, deren letzter Fehler ermittelt
  2821.              werden soll.
  2822.  
  2823. ERGEBNIS
  2824.      error - Die Nummer des zuletzt aufgetretenen Fehlers.
  2825.  
  2826. SIEHE AUCH
  2827.      TR_GetErrorString()
  2828.  
  2829. Die Funktion TR_GetErrorString() - Fehlerbeschreibung anfordern
  2830. ***************************************************************
  2831.  
  2832. NAME
  2833.      string = TR_GetErrorString(error)
  2834.  
  2835. BESCHREIBUNG
  2836.      Besorgt die Beschreibung eines Fehlers im Klartext.
  2837.  
  2838. ARGUMENTE
  2839.      error  - Die Nummer des Fehlers, diese Nummer kann z.B. mit der
  2840.               Funktion 'TR_GetLastError()' ermittelt werden.
  2841.  
  2842. ERGEBNIS
  2843.      string - Die Fehlerbeschreibung im Klartext.
  2844.  
  2845. SIEHE AUCH
  2846.      TR_GetLastError()
  2847.  
  2848. Die Funktion ASL_RequestFile() - Datei-Requester aufrufen
  2849. *********************************************************
  2850.  
  2851. NAME
  2852.      bool = ASL_RequestFile(project,stemvar,taglist)
  2853.  
  2854. BESCHREIBUNG
  2855.      Ruft den Datei-Requester der 'asl.library' auf.
  2856.  
  2857. ARGUMENTE
  2858.      project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
  2859.                soll wΣhrend der Requester ge÷ffnet ist. '00000000'x wenn
  2860.                kein Projekt gesperrt werden soll.
  2861.      
  2862.      stemvar - Stem-Variable, in der die im Requester ausgewΣhlten Datei-
  2863.                oder Verzeichnisnamen gespeichert werden sollen:
  2864.      
  2865.                stemvar.0 - Anzahl der ausgewΣhlten Dateien
  2866.                stemvar.1 - Pfadname der ersten ausgewΣhlten Datei
  2867.                stemvar.2 - Pfadname der zweiten ausgewΣhlten Datei
  2868.                stemvar.3 - Pfadname der dritten ausgewΣhlten Datei
  2869.                stemvar.n - Pfadname der n'ten ausgewΣhlten Datei
  2870.      
  2871.      taglist - Eine Tagliste, die die Eigenschaften des Requesters beschreibt:
  2872.      
  2873.                Kennung                Datenangabe        Beschreibung
  2874.                -----------------------------------------------------------------
  2875.                ASLFR_PubScreenName    Zeichenkette       Name des ÷ffentlichen
  2876.                                                          Bildschirms, auf dem
  2877.                                                          der Requester ge÷ffnet
  2878.                                                          werden soll.
  2879.      
  2880.                ASLFR_Screen           Zeiger             Zeiger auf die Screen-
  2881.                                                          Struktur eines Bild-
  2882.                                                          schirms, auf dem der
  2883.                                                          Requester ge÷ffnet
  2884.                                                          werden soll.
  2885.      
  2886.                ASLFR_TextAttr         TextAttr-Struktur  Stem-Variable, die die
  2887.                                                          TextAttr-Struktur fⁿr
  2888.                                                          den Requester enthΣlt
  2889.                                                          Siehe Taglisten verwenden.
  2890.      
  2891.                ASLFR_TitleText        Zeichenkette       Text in der Titelzeile
  2892.      
  2893.                ASLFR_PositiveText     Zeichenkette       Text fⁿr 'Okay'
  2894.      
  2895.                ASLFR_NegativeText     Zeichenkette       Text fⁿr 'Abbruch'
  2896.      
  2897.                ASLFR_InitialLeftEdge  Integer            Linke Ecke des Fensters
  2898.      
  2899.                ASLFR_InitialTopEdge   Integer            Obere Ecke des Fensters
  2900.      
  2901.                ASLFR_InitialWidth     Integer            Breite des Fensters
  2902.      
  2903.                ASLFR_InitialHeight    Integer            H÷he des Fensters
  2904.      
  2905.                ASLFR_InitialFile      Zeichenkette       Dateiname, der beim
  2906.                                                          ╓ffnen eingetragen
  2907.                                                          werden soll.
  2908.      
  2909.                ASLFR_InitialDrawer    Zeichenkette       Verzeichnis, das beim
  2910.                                                          ╓ffnen eingetragen
  2911.                                                          werden soll.
  2912.      
  2913.                ASLFR_InitialPattern   Zeichenkette       Muster, das  beim
  2914.                                                          ╓ffnen eingetragen
  2915.                                                          werden soll.
  2916.      
  2917.                ASLFR_DoSaveMode       Bool               1 = Speichern-Modus
  2918.      
  2919.                ASLFR_DoMultiSelect    Bool               1 = Mehrfachauswahl
  2920.      
  2921.                ASLFR_DoPatterns       Bool               1 = Muster-Gadget
  2922.      
  2923.                ASLFR_DrawersOnly      Bool               1 = Verzeichnisauswahl
  2924.      
  2925.                ASLFR_RejectIcons      Bool               1 = keine Icons anz.
  2926.      
  2927.                ASLFR_RejectPattern    Zeichenkette       Dateien, auf die das
  2928.                                                          hier angegebene Muster
  2929.                                                          pa▀t werden nicht
  2930.                                                          angezeigt.
  2931.      
  2932.                ASLFR_AcceptPattern    Zeichenkette       Nur Dateien, auf die
  2933.                                                          das hier angegebene
  2934.                                                          Muster pa▀t, werden
  2935.                                                          angezeigt.
  2936.      
  2937.                ASLFR_FilterDrawers    Bool               1 = auch Verzeichnisse
  2938.                                                              mit den Mustern
  2939.                                                              vergleichen
  2940.      
  2941.                Zum Erstellen von Taglisten fⁿr Standard-Requester
  2942.                stehen einige Funktionen zur Verfⁿgung:
  2943.                -------------------------------------------------
  2944.      
  2945.                LoadFile(title,okay,dir,file)
  2946.                     Datei zum Laden auswΣhlen
  2947.      
  2948.                LoadFileI(title,okay,dir,file)
  2949.                     Datei zum Laden auswΣhlen, Icons anzeigen
  2950.      
  2951.                LoadFileP(title,okay,dir,file,pattern)
  2952.                     Datei zum Laden auswΣhlen, Muster-Eingabefeld
  2953.      
  2954.                LoadFileIP(title,okay,dir,file,pattern)
  2955.                     Datei zum Laden auswΣhlen, Muster-Eingabefeld, Icons anzeigen
  2956.      
  2957.                LoadFileM(title,okay,dir,file)
  2958.                     Mehrere Dateien auswΣhlen
  2959.      
  2960.                LoadFileMI(title,okay,dir,file)
  2961.                     Mehrere Dateien auswΣhlen, Icons anzeigen
  2962.      
  2963.                LoadFileMP(title,okay,dir,file,pattern)
  2964.                     Mehrere Dateien auswΣhlen, Muster-Eingabefeld
  2965.      
  2966.                LoadFileMIP(title,okay,dir,file,pattern)
  2967.                     Mehrere Dateien auswΣhlen, Muster-Eingabefeld, Icons anzeigen
  2968.      
  2969.      
  2970.                SaveFile(title,okay,dir,file)
  2971.                     Datei zum Speichern auswΣhlen
  2972.      
  2973.                SaveFileI(title,okay,dir,file)
  2974.                     Datei zum Speichern auswΣhlen, Icons anzeigen
  2975.      
  2976.                SaveFileP(title,okay,dir,file,pattern)
  2977.                     Datei zum Speichern auswΣhlen, Muster-Eingabefeld
  2978.      
  2979.                SaveFileIP(title,okay,dir,file,pattern)
  2980.                     Datei zum Speichern auswΣhlen, Muster-Eingabefeld, Icons anzeigen
  2981.      
  2982.      
  2983.                GetDrawer(title,okay,dir)
  2984.                     Verzeichnis auswΣhlen
  2985.      
  2986.                GetDrawerP(title,okay,dir,pattern)
  2987.                     Verzeichnis auswΣhlen, Muster-Eingabefeld
  2988.  
  2989. ERGEBNIS
  2990.      bool    - 1 wenn etwas ausgewΣhlt wurde, 0 wenn nicht
  2991.  
  2992. SIEHE AUCH
  2993.      -/-
  2994.  
  2995. Die Funktion ASL_RequestFont() - Font-Requester aufrufen
  2996. ********************************************************
  2997.  
  2998. NAME
  2999.      bool = ASL_RequestFont(project,stemvar,taglist)
  3000.  
  3001. BESCHREIBUNG
  3002.      Ruft den Font-Requester der 'asl.library' auf.
  3003.  
  3004. ARGUMENTE
  3005.      project - Die Kennzahl des Projekts, das fⁿr Eingaben gesperrt werden
  3006.                soll wΣhrend der Requester ge÷ffnet ist. '00000000'x wenn
  3007.                kein Projekt gesperrt werden soll.
  3008.      
  3009.      stemvar - Stem-Variable, in der der im Requester ausgewΣhlte Font
  3010.                gespeichert werden soll:
  3011.      
  3012.                stemvar.ta_name  - Name des ausgewΣhlten Fonts
  3013.                stemvar.ta_ysize - Gr÷▀e des ausgewΣhlten Fonts
  3014.                stemvar.ta_style - Stil des ausgewΣhlten Fonts
  3015.                stemvar.ta_flags - Flags des ausgewΣhlten Fonts
  3016.                stemvar.drawmode - der ausgewΣhlte Zeichenmodus
  3017.      
  3018.      taglist - Eine Tagliste, die die Eigenschaften des Requesters beschreibt:
  3019.      
  3020.                Kennung                Datenangabe        Beschreibung
  3021.                ----------------------------------------------------------------
  3022.                ASLFO_PubScreenName    Zeichenkette       Name des ÷ffentlichen
  3023.                                                          Bildschirms, auf dem
  3024.                                                          der Requester ge÷ffnet
  3025.                                                          werden soll.
  3026.      
  3027.                ASLFO_Screen           Zeiger             Zeiger auf die Screen-
  3028.                                                          Struktur eines Bild-
  3029.                                                          schirms, auf dem der
  3030.                                                          Requester ge÷ffnet
  3031.                                                          werden soll.
  3032.      
  3033.                ASLFO_TextAttr         TextAttr-Struktur  Stem-Variable, die die
  3034.                                                          TextAttr-Struktur fⁿr
  3035.                                                          den Requester enthΣlt
  3036.                                                          Siehe Taglisten verwenden.
  3037.      
  3038.                ASLFO_TitleText        Zeichenkette       Text in der Titelzeile
  3039.      
  3040.                ASLFO_PositiveText     Zeichenkette       Text fⁿr 'Okay'
  3041.      
  3042.                ASLFO_NegativeText     Zeichenkette       Text fⁿr 'Abbruch'
  3043.      
  3044.                ASLFO_InitialLeftEdge  Integer            Linke Ecke des Fensters
  3045.      
  3046.                ASLFO_InitialTopEdge   Integer            Obere Ecke des Fensters
  3047.      
  3048.                ASLFO_InitialWidth     Integer            Breite des Fensters
  3049.      
  3050.                ASLFO_InitialHeight    Integer            H÷he des Fensters
  3051.      
  3052.                ASLFO_InitialName      Zeichenkette       Name des Fonts, der
  3053.                                                          beim ╓ffnen ausgewΣhlt
  3054.                                                          sein soll.
  3055.      
  3056.                ASLFO_InitialSize      Integer            Gr÷▀e des Fonts, der
  3057.                                                          beim ╓ffnen ausgewΣhlt
  3058.                                                          sein soll.
  3059.      
  3060.                ASLFO_InitialStyle     Integer            Stil des Fonts, der
  3061.                                                          beim ╓ffnen ausgewΣhlt
  3062.                                                          sein soll.
  3063.      
  3064.                ASLFO_InitialFlags     Integer            Flags des Fonts, der
  3065.                                                          beim ╓ffnen ausgewΣhlt
  3066.                                                          sein soll.
  3067.      
  3068.                ASLFO_InitialDrawMode  Integer            Zeichenmodus des Fonts,
  3069.                                                          der beim ╓ffnen
  3070.                                                          ausgewΣhlt sein soll.
  3071.      
  3072.                ASLFO_DoStyle          Bool               1 = Stil abfragen
  3073.      
  3074.                ASLFO_DoDrawMode       Bool               1 = Zeichenmodus
  3075.                                                              abfragen
  3076.      
  3077.                ASLFO_FixedWidthOnly   Bool               1 = Nur Fonts anzeigen,
  3078.                                                              die eine feste
  3079.                                                              Zeichenbreite haben.
  3080.      
  3081.                ASLFO_MinHeight        Integer            Nur Fonts anzeigen, die
  3082.                                                          mindestens die hier
  3083.                                                          angegebene Gr÷▀e haben
  3084.      
  3085.                ASLFO_MaxHeight        Integer            Nur Fonts anzeigen, die
  3086.                                                          h÷chstens die hier
  3087.                                                          angegebene Gr÷▀e haben
  3088.      
  3089.                ASLFO_ModeList         EintrΣge           Stem-Variable, die die
  3090.                                                          EintrΣge enthΣlt, die
  3091.                                                          im Zeichenmodus-Gadget
  3092.                                                          angezeigt werden sollen
  3093.      
  3094.                Zum Erstellen von Taglisten fⁿr Standard-Requester
  3095.                stehen einige Funktionen zur Verfⁿgung:
  3096.                -------------------------------------------------
  3097.      
  3098.                GetFont(title,okay,fontname,size)
  3099.                     Proportional-Font auswΣhlen
  3100.      
  3101.                GetFWFont(title,okay,fontname,size)
  3102.                     Font mit fester Zeichenbreite auswΣhlen
  3103.  
  3104. ERGEBNIS
  3105.      bool    - 1 wenn etwas ausgewΣhlt wurde, 0 wenn nicht
  3106.  
  3107. SIEHE AUCH
  3108.      -/-
  3109.  
  3110. Die Funktion CreateImage() - Grafik von Disk laden
  3111. **************************************************
  3112.  
  3113. NAME
  3114.      bool = CreateImage(imagename,filename,taglist)        (Ab Kickstart 3.0)
  3115.  
  3116. BESCHREIBUNG
  3117.      LΣdt eine Grafik von Disk und bereitet diese fⁿr die Anzeige in einem
  3118.      Fenster vor. Jede geladene Grafik mu▀ spΣtestens am Ende des Skripts
  3119.      mit 'DeleteImage()' wieder aus dem Speicher gel÷scht werden.
  3120.  
  3121. ARGUMENTE
  3122.      imagename - Ein logischer Name fⁿr die Grafik. Der hier angegebene Name
  3123.                  dient als Parameter fⁿr alle Funktionen und Taglisten, bei
  3124.                  denen die Grafik verwendet werden soll.
  3125.                  Siehe Taglisten verwenden.
  3126.      
  3127.      filename  - Der Pfadname der Grafikdatei, die geladen werden soll. Die
  3128.                  Datei wird mit Hilfe der 'datatypes.library' geladen, es sind
  3129.                  alle Formate erlaubt, fⁿr die Datatypes installiert sind.
  3130.      
  3131.      taglist   - Tagliste, die die Eigenschaften der Grafik beschreibt:
  3132.      
  3133.                  Kennung              Datenangabe    Beschreibung
  3134.                  ---------------------------------------------------------------
  3135.                  TRXIM_PubScreenName  Zeichenkette   Name eines ÷ffentlichen
  3136.                                                      Bildschirms, an dessen
  3137.                                                      Farbpalette die Grafik
  3138.                                                      angepasst werden soll
  3139.      
  3140.                  TRXIM_Screen         Zeiger         Screen-Struktur eines
  3141.                                                      Bildschirms, an dessen
  3142.                                                      Farbpalette die Grafik
  3143.                                                      angepasst werden soll
  3144.      
  3145.                  TRXIM_Flags          Flags
  3146.      
  3147.                                       TRXIF_CENTER   Die Grafik wird immer
  3148.                                                      im Darstellungsbereich
  3149.                                                      zentriert gezeichnet.
  3150.      
  3151.                                                      Standard ist die linke,
  3152.                                                      obere Ecke
  3153.      
  3154.                                       TRXIF_SCALE    Die Grafik wird immer
  3155.                                                      genau an die die Gr÷▀e
  3156.                                                      des Darstellungsbereichs
  3157.                                                      angepasst.
  3158.      
  3159.                                                      StandardmΣ▀ig wird die
  3160.                                                      Gr÷▀e der Grafik nicht
  3161.                                                      verΣndert.
  3162.      
  3163.                                       TRXIF_PROP     Aeim Anpassen an die Gr÷▀e
  3164.                                                      des Darstellungsbereichs
  3165.                                                      bleibt das SeitenverhΣltnis
  3166.                                                      der Grafik immer gleich.
  3167.      
  3168.                                                      Nur in Verbindung mit dem
  3169.                                                      Flag 'TRIXIF_SCALE'
  3170.  
  3171. ERGEBNIS
  3172.      bool      - 1 wenn alles geklappt hat, 0 im Fehlerfall
  3173.  
  3174. SIEHE AUCH
  3175.      DeleteImage() ImageWidth() ImageHeight()
  3176.  
  3177. Die Funktion DeleteImage() - Grafik aus dem Speicher l÷schen
  3178. ************************************************************
  3179.  
  3180. NAME
  3181.      bool = DeleteImage(imagename)
  3182.  
  3183. BESCHREIBUNG
  3184.      L÷scht eine zuvor mit 'CreateImage()' geladene Grafik aus dem Speicher.
  3185.      Eine Grafik kann erst gel÷scht werden wenn sie von keinem Projekt mehr
  3186.      benutzt wird! 'CreateImage()' kann immer gefahrlos aufgerufen werden,
  3187.      auch wenn keine Grafik mit dem angegebenen Namen vorher geladen wurde!
  3188.  
  3189. ARGUMENTE
  3190.      imagename - Der logische Name der Grafik, die gel÷scht werden soll.
  3191.  
  3192. ERGEBNIS
  3193.      bool      - 1 wenn die Grafik gel÷scht wurde. Wenn die Grafik nicht
  3194.                  gel÷scht werden konnte wird 0 zurⁿckgegeben. Dies passiert
  3195.                  wenn die Grafik noch im Fenster eines Projekts dargestellt
  3196.                  wird, oder eine Grafik mit dem angegebenen Namen nicht
  3197.                  existiert.
  3198.  
  3199. SIEHE AUCH
  3200.      CreateImage() ImageWidth() ImageHeight()
  3201.  
  3202. Die Funktion ImageWidth()
  3203. *************************
  3204.  
  3205. NAME
  3206.      width = ImageWidth(imagename)
  3207.  
  3208. BESCHREIBUNG
  3209.      Ermittelt die Breite einer Grafik. Es wird immer die Breite der nicht
  3210.      skalierten Grafik zurⁿckgegeben.
  3211.  
  3212. ARGUMENTE
  3213.      imagename - Der logische Name einer mit 'CreateImage()' geladenen Grafik,
  3214.  
  3215. ERGEBNIS
  3216.      width     - Die Breite der Grafik in Pixel
  3217.  
  3218. SIEHE AUCH
  3219.      CreateImage() DeleteImage() ImageHeight()
  3220.  
  3221. Die Funktion ImageHeight()
  3222. **************************
  3223.  
  3224. NAME
  3225.      height = ImageHeight(imagename)
  3226.  
  3227. BESCHREIBUNG
  3228.      Ermittelt die H÷he einer Grafik. Es wird immer die H÷he der nicht
  3229.      skalierten Grafik zurⁿckgegeben.
  3230.  
  3231. ARGUMENTE
  3232.      imagename - Der logische Name einer mit 'CreateImage()' geladenen Grafik
  3233.  
  3234. ERGEBNIS
  3235.      height    - Die H÷he der Grafik in Pixel
  3236.  
  3237. SIEHE AUCH
  3238.      CreateImage() DeleteImage() ImageWidth()
  3239.  
  3240. Die Funktion TritonRexxVersion() - Version der 'tritonrexx.library' ermitteln
  3241. *****************************************************************************
  3242.  
  3243. NAME
  3244.      version = TritonRexxVersion()
  3245.  
  3246. BESCHREIBUNG
  3247.      Gibt die Version der 'tritonrexx.library' zurⁿck.
  3248.  
  3249. ARGUMENTE
  3250.      -/-
  3251.  
  3252. ERGEBNIS
  3253.      version - Die Version der Library, z.B. 37.2
  3254.  
  3255. SIEHE AUCH
  3256.      TritonVersion()
  3257.  
  3258. Die Funktion TritonVersion() - Version der 'triton.library' ermitteln
  3259. *********************************************************************
  3260.  
  3261. NAME
  3262.      version = TritonVersion()
  3263.  
  3264. BESCHREIBUNG
  3265.      Gibt die Version der 'triton.library' zurⁿck.
  3266.  
  3267. ARGUMENTE
  3268.      -/-
  3269.  
  3270. ERGEBNIS
  3271.      version - Die Version der Library, z.B. 4.39
  3272.  
  3273. SIEHE AUCH
  3274.      TritonRexxVersion()
  3275.  
  3276. Index und Stichwortverzeichnis
  3277. ******************************
  3278.  
  3279.  
  3280.  
  3281.  ▄bersicht                             ▄bersicht
  3282.  ActivateProject()                      ActivateProject()
  3283.  Adresse des Autors                     Adresse des Autors
  3284.  Applikation erzeugen                   TR_CreateApp()
  3285.  Applikation l÷schen                   TR_DeleteApp()
  3286.  Applikationen                          Applikationen und Projekte
  3287.  Applikationen                          Applikationen
  3288.  Applikationen und Projekte             Applikationen und Projekte
  3289.  ASL_RequestFile()                      ASL_RequestFile()
  3290.  ASL_RequestFont()                      ASL_RequestFont()
  3291.  Attribute Σndern                      TR_SetAttribute()
  3292.  Attribute abfragen                     TR_GetAttribute()
  3293.  Auswahl von Farben                     Palette
  3294.  Autor                                  Adresse des Autors
  3295.  Bildschirm freigeben                   TR_UnlockScreen()
  3296.  Bildschirm sperren                     TR_LockScreen()
  3297.  Breite einer Grafik ermitteln          ImageWidth()
  3298.  Button                                 Button
  3299.  CheckBox                               CheckBox
  3300.  Copyright                              Copyright
  3301.  CreateImage()                          CreateImage()
  3302.  Cycle                                  Cycle
  3303.  Danksagungen                           Danksagungen
  3304.  Datei-Requester                        ASL_RequestFile()
  3305.  DeleteImage()                          DeleteImage()
  3306.  DropBox                                DropBox
  3307.  Eigenschaften von Applikationen        Applikationen
  3308.  Eigenschaften von Fenstern             Projekte-Fenster
  3309.  Eigenschaften von Menⁿs               Menⁿs
  3310.  Ein/Aus Schalter                       CheckBox
  3311.  Einfache Requester                     TR_EasyRequest()
  3312.  Eingaben erlauben                      TR_UnlockProject()
  3313.  Eingaben verbieten                     TR_LockProject()
  3314.  Einrahmen von Gruppen                  FrameBox
  3315.  Einrahmen von Objekten                 FrameBox
  3316.  Entstehungsgeschichte                  History
  3317.  Fⁿllmuster fⁿr Fenster               Fⁿllmuster fⁿr Fenster
  3318.  Fⁿllmuster fⁿr Objekte               Fⁿllmuster fⁿr Objekte
  3319.  Farbauswahl                            Palette
  3320.  Fehler ermitteln                       TR_GetLastError()
  3321.  Fehlerbeschreibung ermitteln           TR_GetErrorString()
  3322.  Felder zur Mehrfachauswahl             Cycle
  3323.  Fenster ÷ffnen                        TR_OpenProject()
  3324.  Fenster ⁿbernehmen                    TR_ObtainWindow()
  3325.  Fenster als Requester                  TR_AutoRequest()
  3326.  Fenster eines Projekts aktivieren      ActivateProject()
  3327.  Fenster eines Projekts nach hinten     ProjectToBack()
  3328.  Fenster eines Projekts nach vorne      ProjectToFront()
  3329.  Fenster freigeben                      TR_UnlockProject()
  3330.  Fenster freigeben                      TR_ReleaseWindow()
  3331.  Fenster schlie▀en                     TR_CloseProject()
  3332.  Fenster sperren                        TR_LockProject()
  3333.  Fenster-Fⁿllmuster                    Fⁿllmuster fⁿr Fenster
  3334.  FlΣchen zum Fallenlassen  von Icons   DropBox
  3335.  FlushTRX                               FlushTRX
  3336.  Font-Requester                         ASL_RequestFont()
  3337.  Fortschrittsanzeige                    Progress
  3338.  FrameBox                               FrameBox
  3339.  Funktion ActivateProject()             ActivateProject()
  3340.  Funktion ASL_RequestFile()             ASL_RequestFile()
  3341.  Funktion ASL_RequestFont()             ASL_RequestFont()
  3342.  Funktion CreateImage()                 CreateImage()
  3343.  Funktion DeleteImage()                 DeleteImage()
  3344.  Funktion ImageHeight()                 ImageHeight()
  3345.  Funktion ImageWidth()                  ImageWidth()
  3346.  Funktion ProjectToBack()               ProjectToBack()
  3347.  Funktion ProjectToFront()              ProjectToFront()
  3348.  Funktion TritonRexxVersion()           TritonRexxVersion()
  3349.  Funktion TritonVersion()               TritonVersion()
  3350.  Funktion TR_AutoRequest()              TR_AutoRequest()
  3351.  Funktion TR_CloseProject()             TR_CloseProject()
  3352.  Funktion TR_CreateApp()                TR_CreateApp()
  3353.  Funktion TR_DeleteApp()                TR_DeleteApp()
  3354.  Funktion TR_EasyRequest()              TR_EasyRequest()
  3355.  Funktion TR_FirstOccurance()           TR_FirstOccurance()
  3356.  Funktion TR_GetAttribute()             TR_GetAttribute()
  3357.  Funktion TR_GetErrorString()           TR_GetErrorString()
  3358.  Funktion TR_GetLastError()             TR_GetLastError()
  3359.  Funktion TR_GetMsg()                   TR_GetMsg()
  3360.  Funktion TR_HandleMsg()                TR_HandleMsg()
  3361.  Funktion TR_LockProject()              TR_LockProject()
  3362.  Funktion TR_LockScreen()               TR_LockScreen()
  3363.  Funktion TR_NumOccurances()            TR_NumOccurances()
  3364.  Funktion TR_ObtainWindow()             TR_ObtainWindow()
  3365.  Funktion TR_OpenProject()              TR_OpenProject()
  3366.  Funktion TR_ReleaseWindow()            TR_ReleaseWindow()
  3367.  Funktion TR_ReplyMsg()                 TR_ReplyMsg()
  3368.  Funktion TR_SendMessage()              TR_SendMessage()
  3369.  Funktion TR_SetAttribute()             TR_SetAttribute()
  3370.  Funktion TR_UnlockProject()            TR_UnlockProject()
  3371.  Funktion TR_UnlockScreen()             TR_UnlockScreen()
  3372.  Funktion TR_Wait()                     TR_Wait()
  3373.  Funktionen                             Funktionen
  3374.  Funktionen der Library                 Funktionen
  3375.  Gemeinsamkeiten mit der 'triton.library'triton.library
  3376.  Grafik l÷schen                        DeleteImage()
  3377.  Grafik von Disk laden                  CreateImage()
  3378.  Grafiken                               Image
  3379.  Group                                  Group
  3380.  Gruppen                                Group
  3381.  Gruppen einrahmen                      FrameBox
  3382.  H÷he einer Grafik ermitteln           ImageHeight()
  3383.  History                                History
  3384.  Image                                  Image
  3385.  Image l÷schen                         DeleteImage()
  3386.  Image von Disk laden                   CreateImage()
  3387.  ImageHeight()                          ImageHeight()
  3388.  ImageWidth()                           ImageWidth()
  3389.  Index                                  Index
  3390.  Informationen ⁿber 'Triton'           Triton-Info
  3391.  Installation                           Installation
  3392.  Kn÷pfe                                Button
  3393.  Kurze Vorstellung der Library          ▄bersicht
  3394.  Kurzhilfe                              QuickHelp
  3395.  LeerrΣume zwischen Objekten           Space
  3396.  Line                                   Line
  3397.  Listen zur Darstellung und Auswahl     Listview
  3398.  Listview                               Listview
  3399.  Mehrfachauswahl                        Cycle
  3400.  Menⁿs                                 Menⁿs
  3401.  Nachricht beantworten                  TR_Wait()
  3402.  Nachricht beantworten                  TR_ReplyMsg()
  3403.  Nachricht empfangen                    TR_GetMsg()
  3404.  Nachricht empfangen und beantworten    TR_HandleMsg()
  3405.  Nachrichten an Objekte                 TR_SendMessage()
  3406.  OberflΣchen erstellen                 OberflΣchen erstellen
  3407.  Objekt-Fⁿllmuster                     Fⁿllmuster fⁿr Objekte
  3408.  Objekte einrahmen                      FrameBox
  3409.  Objekte und Attribute                  Objekte und Attribute
  3410.  Palette                                Palette
  3411.  Progress                               Progress
  3412.  ProjectToBack()                        ProjectToBack()
  3413.  ProjectToFront()                       ProjectToFront()
  3414.  Projekt ÷ffnen                        TR_OpenProject()
  3415.  Projekt freigeben                      TR_UnlockProject()
  3416.  Projekt schlie▀en                     TR_CloseProject()
  3417.  Projekt sperren                        TR_LockProject()
  3418.  Projekte                               Applikationen und Projekte
  3419.  Projekte/Fenster                       Projekte-Fenster
  3420.  QuickHelp                              QuickHelp
  3421.  Rechliches                             Copyright
  3422.  Schieberegler zum Scrollen durch ListenScroller
  3423.  Schieberegler zur Einstellung von WertenSlider
  3424.  Screen-Zeiger ermitteln                TR_LockScreen()
  3425.  Scroller                               Scroller
  3426.  Slider                                 Slider
  3427.  Space                                  Space
  3428.  Stichwortverzeichnis                   Index
  3429.  String                                 String
  3430.  Support-Mailbox                        Adresse des Autors
  3431.  Systemvoraussetzungen                  Systemvoraussetzungen
  3432.  Taglisten verwenden                    Taglisten verwenden
  3433.  Text                                   Text
  3434.  Texte in verschiedenen DarstellungsartenText
  3435.  Texteingabefelder                      String
  3436.  Tips und Probleml÷sungen              Tips und Probleml÷sungen
  3437.  Trennlinien                            Line
  3438.  Triton-Info                            Triton-Info
  3439.  Triton-Version ermitteln               TritonVersion()
  3440.  triton.library                         triton.library
  3441.  TritonRexx-Version ermitteln           TritonRexxVersion()
  3442.  TritonRexxVersion()                    TritonRexxVersion()
  3443.  TritonVersion()                        TritonVersion()
  3444.  TR_AutoRequest()                       TR_AutoRequest()
  3445.  TR_CloseProject()                      TR_CloseProject()
  3446.  TR_CreateApp()                         TR_CreateApp()
  3447.  TR_DeleteApp()                         TR_DeleteApp()
  3448.  TR_EasyRequest()                       TR_EasyRequest()
  3449.  TR_FirstOccurance()                    TR_FirstOccurance()
  3450.  TR_GetAttribute()                      TR_GetAttribute()
  3451.  TR_GetErrorString()                    TR_GetErrorString()
  3452.  TR_GetLastError()                      TR_GetLastError()
  3453.  TR_GetMsg()                            TR_GetMsg()
  3454.  TR_HandleMsg()                         TR_HandleMsg()
  3455.  TR_LockProject()                       TR_LockProject()
  3456.  TR_LockScreen()                        TR_LockScreen()
  3457.  TR_NumOccurances()                     TR_NumOccurances()
  3458.  TR_ObtainWindow()                      TR_ObtainWindow()
  3459.  TR_OpenProject()                       TR_OpenProject()
  3460.  TR_ReleaseWindow()                     TR_ReleaseWindow()
  3461.  TR_ReplyMsg()                          TR_ReplyMsg()
  3462.  TR_SendMessage()                       TR_SendMessage()
  3463.  TR_SetAttribute()                      TR_SetAttribute()
  3464.  TR_UnlockProject()                     TR_UnlockProject()
  3465.  TR_UnlockScreen()                      TR_UnlockScreen()
  3466.  TR_Wait()                              TR_Wait()
  3467.  Was tun wenn...                        Tips und Probleml÷sungen
  3468.  Window-Zeiger ermitteln                TR_ObtainWindow()
  3469.  Zeichen suchen                         TR_FirstOccurance()
  3470.  Zeichen zΣhlen                        TR_NumOccurances()
  3471.  
  3472.